Difference between revisions of "API: Server configuration"
From BrainyCP
m (Fgsfds переименовал страницу API: настройки сервера в API: Server configuration) |
|||
Line 1: | Line 1: | ||
− | + | <div data-placeholder="Перевод" dir="ltr">Administrative functions require API root rights in order to use any login hosted on the server. If you do not have root rights, you can only use your login.</div> <div data-placeholder="Перевод" dir="ltr">Incoming data marked with an asterisk are required.</div> | |
− | |||
− | |||
− | |||
− | |||
{| border="1" cellpadding="5" | {| border="1" cellpadding="5" | ||
|- | |- | ||
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Module'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Function'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Incoming data'''</p> |
− | | <p dir="ltr" style="text-align: center;">''' | + | | <p dir="ltr" style="text-align: center;">'''Error variants'''</p> |
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
properties | properties | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr" id="tw-target-text">Server properties at the time of request execution (date and time, time zone, hostname, language, etc.).</div> |
− | |||
− | |||
getproper | getproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">getproperties (post or get) * - constant, operation type;</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'Information was received successfully';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while receiving information';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'. If done correctly, the array will contain the following elements:</div> <div data-placeholder="Перевод" dir="ltr">[time], [locale], [hostname], [tz_date], [tz_time], [tz_time_m], [tz_time_s], [tz_time_h], [tz_timezone], [timezone_path], [timezone_name], [tz_sync]</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | getproperties (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
− | [time], [locale],[hostname],[tz_date],[tz_time],[tz_time_m],[tz_time_s],[tz_time_h],[tz_timezone],[timezone_path],[timezone_name], [tz_sync] | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 44: | Line 20: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change time. | |
settimeproper | settimeproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">settimeproperties (post or get) * - constant, operation type;</div> <div data-placeholder="Перевод" dir="ltr">date (post or get) * - new time in the format 'Dec 14 00:05:00 EST 2016';</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'New date was set successfully';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'New time has been set';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | settimeproperties (post | ||
− | |||
− | date (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 73: | Line 31: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change time zone. | |
settzproper | settzproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">settzproper (post or get) * - constant, operation type;</div> <div data-placeholder="Перевод" dir="ltr">tz (post or get) * - new time zone. For example, EST or WET;</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'Time zone changed successfully';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while changing the time zone';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'The specified time zone is invalid';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | settzproper (post | ||
− | |||
− | tz (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 104: | Line 42: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change Hostname. | |
sethostnameproper | sethostnameproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">sethostnameproper (post or get) * - constant, operation type;</div> <div data-placeholder="Перевод" dir="ltr">hostname (post or get) * - new hostname;</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'New hostname set';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while setting a new hostname';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'Invalid hostname';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | sethostnameproper (post | ||
− | |||
− | hostname (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 135: | Line 53: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change root-password. | |
changerootpassprop | changerootpassprop | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">changerootpassprop (post or get) * - constant, operation name;</div> <div data-placeholder="Перевод" dir="ltr">rootps (post or get) * - new password for root;</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'Root password changed successfully';</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while changing the root password';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'The new root password is too short, at least 8 characters';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | changerootpassprop (post | ||
− | |||
− | rootps (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 166: | Line 64: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change brainysql-password. | |
changebrainysqlpassproper | changebrainysqlpassproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">changebrainysqlpassproper (post or get) * - constant, operation name;</div> <div data-placeholder="Перевод" dir="ltr">rootps (post or get) * - new password for brainysql;</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'The password for brainysql has been successfully changed;</div> <div data-placeholder="Перевод" dir="ltr">error: 1, mess: 'An error occurred while changing the password for brainysql';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'The new password for brainysql is too short, at least 8 characters';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | changebrainysqlpassproper (post | ||
− | |||
− | rootps (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:1, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 197: | Line 75: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change language. | |
changelangproper | changelangproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">changelangproper (post or get) * - constant, operation name;</div> <div data-placeholder="Перевод" dir="ltr">lang (post or get) * - setting the language ('ru' or 'en');</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default).</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'The selected language has been successfully installed';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'Invalid language parameter specified';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | changelangproper (post | ||
− | |||
− | lang (post | ||
− | |||
− | language (post | ||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|- | |- | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
Line 226: | Line 86: | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | + | Change data for sending mails by panel. | |
changetypemailproper | changetypemailproper | ||
− | | style="vertical-align: top;" | | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">username (post or get) * - username;</div> <div data-placeholder="Перевод" dir="ltr">password (post or get) * - user password;</div> <div data-placeholder="Перевод" dir="ltr">properties (post or get) * - constant, module name;</div> <div data-placeholder="Перевод" dir="ltr">changetypemailproper (post or get) * - constant, operation name:</div> <div data-placeholder="Перевод" dir="ltr">type (post or get) * - mail sender (smtp or phpmail);</div> <div data-placeholder="Перевод" dir="ltr">language (post or get) - can take the value: en / ru (ru by default). if 'type' = smtp, then the following parameters are requested:</div> <div data-placeholder="Перевод" dir="ltr">smtp_user (post or get) * - mailbox on behalf of whom the authentication is going on;</div> <div data-placeholder="Перевод" dir="ltr">smtp_pass (post or get) * - password for this user;</div> <div data-placeholder="Перевод" dir="ltr">smtp_port (post or get) * - smtp port;</div> <div data-placeholder="Перевод" dir="ltr">smtp_host (post or get) * - hostname of the smtp service;</div> <div data-placeholder="Перевод" dir="ltr">encoding (post or get) - encoding;</div> <div data-placeholder="Перевод" dir="ltr">smtp_from (post or get) - sender's name;</div> <div data-placeholder="Перевод" dir="ltr">smtp_headers - headers. if 'type' = phpmail, then the following parameters are requested:</div> <div data-placeholder="Перевод" dir="ltr">smtp_headers (post or get) - headers.</div> |
− | username (post | + | | style="vertical-align: top;" | <div data-placeholder="Перевод" dir="ltr">error: 0, mess: 'New parameters have been successfully applied';</div> <div data-placeholder="Перевод" dir="ltr">error: 2, mess: 'The specified mailbox is invalid';</div> <div data-placeholder="Перевод" dir="ltr">error: 3, mess: 'The specified hostname is invalid';</div> <div data-placeholder="Перевод" dir="ltr">error: 4, mess: 'The port is not defined or it is invalid';</div> <div data-placeholder="Перевод" dir="ltr">error: 1000, mess: 'You do not have administrator rights'.</div> |
− | |||
− | password (post | ||
− | |||
− | properties (post | ||
− | |||
− | changetypemailproper (post | ||
− | |||
− | type (post | ||
− | |||
− | language (post | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | style="vertical-align: top;" | | ||
− | error:0, mess:' | ||
− | |||
− | error:2, mess:' | ||
− | |||
− | error:3, mess:' | ||
− | |||
− | error:4, mess:' | ||
− | |||
− | error:1000, mess:' | ||
− | |||
|} | |} | ||
− | + | Other useful articles: | |
{| style="width: 1191px;" | {| style="width: 1191px;" |
Revision as of 23:27, 10 April 2021
Administrative functions require API root rights in order to use any login hosted on the server. If you do not have root rights, you can only use your login.
Incoming data marked with an asterisk are required.
Module |
Function |
Incoming data |
Error variants |
properties |
Server properties at the time of request execution (date and time, time zone, hostname, language, etc.).
getproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; getproperties (post or get) * - constant, operation type; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'Information was received successfully'; error: 1, mess: 'An error occurred while receiving information'; error: 1000, mess: 'You do not have administrator rights'. If done correctly, the array will contain the following elements: [time], [locale], [hostname], [tz_date], [tz_time], [tz_time_m], [tz_time_s], [tz_time_h], [tz_timezone], [timezone_path], [timezone_name], [tz_sync]
|
properties |
Change time. settimeproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; settimeproperties (post or get) * - constant, operation type; date (post or get) * - new time in the format 'Dec 14 00:05:00 EST 2016'; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'New date was set successfully'; error: 1, mess: 'New time has been set'; error: 1000, mess: 'You do not have administrator rights'.
|
properties |
Change time zone. settzproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; settzproper (post or get) * - constant, operation type; tz (post or get) * - new time zone. For example, EST or WET; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'Time zone changed successfully'; error: 1, mess: 'An error occurred while changing the time zone'; error: 2, mess: 'The specified time zone is invalid'; error: 1000, mess: 'You do not have administrator rights'.
|
properties |
Change Hostname. sethostnameproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; sethostnameproper (post or get) * - constant, operation type; hostname (post or get) * - new hostname; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'New hostname set'; error: 1, mess: 'An error occurred while setting a new hostname'; error: 2, mess: 'Invalid hostname'; error: 1000, mess: 'You do not have administrator rights'.
|
properties |
Change root-password. changerootpassprop |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; changerootpassprop (post or get) * - constant, operation name; rootps (post or get) * - new password for root; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'Root password changed successfully'; error: 1, mess: 'An error occurred while changing the root password'; error: 2, mess: 'The new root password is too short, at least 8 characters'; error: 1000, mess: 'You do not have administrator rights'
|
properties |
Change brainysql-password. changebrainysqlpassproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; changebrainysqlpassproper (post or get) * - constant, operation name; rootps (post or get) * - new password for brainysql; language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'The password for brainysql has been successfully changed; error: 1, mess: 'An error occurred while changing the password for brainysql'; error: 2, mess: 'The new password for brainysql is too short, at least 8 characters'; error: 1000, mess: 'You do not have administrator rights'.
|
properties |
Change language. changelangproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; changelangproper (post or get) * - constant, operation name; lang (post or get) * - setting the language ('ru' or 'en'); language (post or get) - can take the value: en / ru (ru by default).
|
error: 0, mess: 'The selected language has been successfully installed'; error: 2, mess: 'Invalid language parameter specified'; error: 1000, mess: 'You do not have administrator rights'.
|
properties |
Change data for sending mails by panel. changetypemailproper |
username (post or get) * - username; password (post or get) * - user password; properties (post or get) * - constant, module name; changetypemailproper (post or get) * - constant, operation name: type (post or get) * - mail sender (smtp or phpmail); language (post or get) - can take the value: en / ru (ru by default). if 'type' = smtp, then the following parameters are requested: smtp_user (post or get) * - mailbox on behalf of whom the authentication is going on; smtp_pass (post or get) * - password for this user; smtp_port (post or get) * - smtp port; smtp_host (post or get) * - hostname of the smtp service; encoding (post or get) - encoding; smtp_from (post or get) - sender's name; smtp_headers - headers. if 'type' = phpmail, then the following parameters are requested: smtp_headers (post or get) - headers.
|
error: 0, mess: 'New parameters have been successfully applied'; error: 2, mess: 'The specified mailbox is invalid'; error: 3, mess: 'The specified hostname is invalid'; error: 4, mess: 'The port is not defined or it is invalid'; error: 1000, mess: 'You do not have administrator rights'.
|
Other useful articles: