Skip to content

Installer API

Sayar Samanta edited this page Aug 28, 2018 · 3 revisions

Description : To create an alternative installer outside Faveo Helpdesk to install Faveo Helpdesk via one step installation.

Parameters :

Name Data Type Required/Optional Description
default String Required Faveo makes connection with databases and running queries extremely simple across a variety of database.Currently Faveo supports three database systems (mysql,pgsql,sqlsrv)
host String Required Here goes the database server IP address
databasename String Required Name of database
dbusername String Required Database user name
dbpassword String Required Database user’s password
port Integer Optional Port has to be filled if required. In some cases port are required to connect to the database server.Eg:- 8888
firstname String Required, Alphabetical first name of Admin
lastname String Required, Alphabetical last name of Admin
email String Required, Email email of admin
username String Required Username of the admin / could be admin
password String Required Password (min:6)
timezone String Required Below are the mentioned the list of time-zones supported by Faveo Pacific/Midway
US/Samoa
US/Hawaii
US/Alaska
US/Pacific
America/Tijuana
US/Arizona
US/Mountain
America/Chihuahua
America/Mazatlan
America/Mexico_City
America/Monterrey
Canada/Saskatchewan
US/Central
US/Eastern
US/EastIndiana
America/Bogota
America/Lima
America/Caracas
Canada/Atlantic
America/La_Paz
America/Santiago
Canada/Newfoundland
America/Buenos_Aires
Greenland
Atlantic/Stanley
Atlantic/Azores
Atlantic/Cape_Verde
Africa/Casablanca
Europe/Dublin
Europe/Lisbon
Europe/London
Africa/Monrovia
Europe/Amsterdam
Europe/Belgrade
Europe/Berlin
Europe/Bratislava
Europe/Brussels
Europe/Budapest
Europe/Copenhagen
Europe/Ljubljana
Europe/Madrid
Europe/Paris
Europe/Prague
Europe/Rome
Europe/Sarajevo
Europe/Skopje
Europe/Stockholm
Europe/Vienna
Europe/Warsaw
Europe/Zagreb
Europe/Athens
Europe/Bucharest
Africa/Cairo
Africa/Harare
Europe/Helsinki
Europe/Istanbul
Asia/Jerusalem
Europe/Kiev
Europe/Minsk
Europe/Riga
Europe/Sofia
Europe/Tallinn
Europe/Vilnius
Asia/Baghdad
Asia/Kuwait
Africa/Nairobi
Asia/Riyadh
Asia/Tehran
Europe/Moscow
Asia/Baku
Europe/Volgograd
Asia/Muscat
Asia/Tbilisi
Asia/Yerevan
Asia/Kabul
Asia/Karachi
Asia/Tashkent
Asia/Kolkata
Asia/Kathmandu
Asia/Yekaterinburg
Asia/Almaty
Asia/Dhaka
Asia/Novosibirsk
Asia/Bangkok
Asia/Ho_Chi_Minh
Asia/Jakarta
Asia/Krasnoyarsk
Asia/Chongqing
Asia/Hong_Kong
Asia/Kuala_Lumpur
Australia/Perth
Asia/Singapore
Asia/Taipei
Asia/Ulaanbaatar
Asia/Urumqi
Asia/Irkutsk
Asia/Seoul
Asia/Tokyo
Australia/Adelaide
Australia/Darwin
Asia/Yakutsk
Australia/Brisbane
Australia/Canberra
Pacific/Guam
Australia/Hobart
Australia/Melbourne
Pacific/Port_Moresby
Australia/Sydney
Asia/Vladivostok
Asia/Magadan
Pacific/Auckland
Pacific/Fiji
datetime String Required Below are mentioned the required format for date formats
d/m/Y H:i:s
d.m.Y H:i:s
d-m-Y H:i:s
m/d/Y H:i:s
m.d.Y H:i:s
m-d-Y H:i:s
Y/m/d H:i:s
Y.m.d H:i:s
Y-m-d H:i:s

HTTP Method : GET

URL Request Example :

Url to config database :

http://www.website.com/support/api/v1/database-config?database=mysql&host=localhost&databasename=dbname&dbusername=root&dbpassword=anything&port=8888

1. If you have public in your URL then try this mentioned below :

http://www.website.com/support/public/api/v1/database-config?database=mysql&host=localhost&databasename=dbname&dbusername=root&dbpassword=anything&port=8888

Parameters :

  1.Database
  2.Host
  3.Databsename
  4.Databaseusername
  5.Databasepassword
  6.Port

2. Url to migrate database and create admin credentials :

http://www.website.com/support/api/v1/system-config?firstname=admin&lastname=admin&email=admin%40faveo.com&username=admin%40faveo.com&password=demopass&timezone=Asia%2FKolkata&datetime=d%2Fm%2FY+H%3Ai%3As If you have public in your URL then try this mentioned below http://www.website.com/support/public/api/v1/system-config?firstname=admin&lastname=admin&email=admin%40faveo.com&username=admin%40faveo.com&password=demopass&timezone=Asia%2FKolkata&datetime=d%2Fm%2FY+H%3Ai%3As

Parameters :

 1.firstname
 2.lastname
 3.email
 4.username
 5.password
 6.timezone
 7.datetime

Explanation of the URL’s :

Here we have two urls :

1.In the first url one can configure the config database file. 2.In the second url one needs to migrate the database and register the user details to the database.

Response :

Success response :

{‘response'=>'success','status'=>'1'}

Failure response :

For re-installation :

{'response'=>'fail','reason'=>'this system is already installed', 'status'=>'0'}

For insufficient/error in parameters :

  • {"response":"fail","reason":"The firstname field is required,The lastname field is required,The email field is required,The username field is required,The password field is required,The timezone field is required,The datetime field is required","status":"0"}
  • {"response":"fail","reason":"The database field is required,The host field is required,The databasename field is required,The dbusername field is required","status":"0"}
  • {'response'=>'fail','reason'=>'insufficient parameters','status'=>'0'}
  • {'response'=>'fail','reason'=>'Invalid time-zone','status'=>'0'}
  • {'response'=>'fail','reason'=>'invalid date-time format','status'=>'0'}

Installation and Upgrade Guide

Administrator's Guide

Agent's Guide

Email Integration

Release & Upgrade Notes

Known Issues

Contribute & Feedback

Knowledge Base

Third Party Integration

Plugins

API

Clone this wiki locally