База знаний
Общая информация

Для доступа к API нужен токен. Он выдается по запросу в службе поддержки.


Использование

Необходимо сделать POST-запрос на https://app.stepchat.io/include/api.php. Использовать можно следующий код:

function step_chat_api($query) {
$ch = curl_init('https://app.stepchat.io/include/api.php');
$parameters = [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => false,
CURLOPT_USERAGENT => 'StepChat',
CURLOPT_POST => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_POSTFIELDS => http_build_query(array_merge(['token' => 'ВАШ-ТОКЕН'], $query))
];
curl_setopt_array($ch, $parameters);
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}

Пример использования: step_chat_api(['function' => 'get-user', 'user_id' => 123]).

Внимание! Данная функция небезопасна, поскольку файлы .js доступны любому пользователю. Убедитесь, что данный код доступен только соответствующему пользователю.

$.post('https://app.stepchat.io/include/api.php', {
function: 'METHOD-NAME',
token: 'YOUR-TOKEN'
}, function (response) {
response = JSON.parse(response);
if (response.success) {
}
});

Переменная $response будет содержать ответ в формате JSON. Вы можете добавлять новые аргументы в массив запроса: ['token' => '', 'function' => '', 'название-аргумента' => 'значение', ...].


Замените следующие строки на соответствующие значения:

  • Замените YOUR-TOKEN на токен, которая выдала наша техподдержка.
  • Замените METHOD-NAME на название функции API, которую вы хотите использовать. Получите их из списка методов ниже.

Информация

  • Для безопасности некоторые функции защищены. Для правильного их выполнения перед вызовом установите код $GLOBALS['SB_FORCE_ADMIN'] = true, а после вызова $GLOBALS['SB_FORCE_ADMIN'] = false.
  • Некоторые функции требуют данные о пользователе. Используйте код $GLOBALS['SB_LOGIN'] = ['id' => '', 'first_name' => '', 'last_name' => '', 'email' => '', 'user_type' => '', 'department' => '']; для получения данных о пользователе.