Это старая версия документа!
Хостинг Украина API
Для API используется специальная прослойка между вызовами через веб-интерфейс панели управления. Она позволяет авторизоваться по токену, выполнять запросы от имени пользователя и получать ответы в формате JSON
Преимущества подхода:
- Большинство действий, которые можно выполнять через панель управления, могут быть выполнены через API.
- Всегда актуальное API. Основной функционал панели управления сразу доступен через API.
- Стабильность работы API. Работа панели управления ежедневно проверяется тысячами пользователей.
Нюансы подхода:
- Некоторые функции API могут быть изменены без предупреждения. Однако по нашим наблюдениям появление новых параметров должно оказывать минимальное влияние на работу существующих функций API.
Использование
Для использования API нужно отправлять запросы к определённым событиям, передавая необходимые данные методами GET или POST. Запрос будет выполнен только в том случае, если присутствует авторизационный заголовок Authorization: Bearer [token]
.
Адрес для отправки запросов API:
https://adm.tools/actions/событие
Пример использования:
<?php $ch = curl_init("https://adm.tools/action/path/to/method/"); curl_setopt_array($ch, array( CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => array("Authorization: Bearer placeuserapitokenhere"), CURLOPT_POSTFIELDS => {"data1" => "value1", "data2" => "value2"}, CURLOPT_VERBOSE => true, )); $response = curl_exec($ch);
Коды ответов
- 200 OK — событие отработало успешно без ошибок или исключений.
- 400 Bad Request — в процессе работы события возникла ошибка или исключение.
- 401 Unauthorized — некорректный токен.
- 403 Forbidden — ошибка доступа к событию.
- 405 Method Not Allowed — попытка обращения к несуществующему событию.
- 429 Too Many Requests — слишком много запросов.