Это старая версия документа!
Хостинг Украина API
Внимание!
- На данном сайте представлена документация к новому API. Документация к старому API находится здесь. Старое API будет работать до 1 марта 2021 г.
- Документация находится в процессе доработки. Описания методов могут изменяться/дополняться.
Для API используется специальная прослойка между вызовами через веб-интерфейс панели управления. Она позволяет авторизоваться по токену, выполнять запросы от имени пользователя и получать ответы в формате JSON
Преимущества подхода:
- Большинство действий, которые можно выполнять через панель управления, могут быть выполнены через API.
- Всегда актуальное API. Основной функционал панели управления сразу доступен через API.
- Стабильность работы API. Работа панели управления ежедневно проверяется тысячами пользователей.
Нюансы подхода:
- Некоторые функции API могут быть изменены без предупреждения. Однако по нашим наблюдениям появление новых параметров должно оказывать минимальное влияние на работу существующих функций API.
Пожелания и предложения:
- Все ваши пожелания и предложения по работе API присылайте в соответствующий раздел на форуме: Пожелания и предложения.
Важные моменты:
- Ограничение доступа к API — 2 запроса в секунду для токена.
- Для авторизации используется Bearer token.
Использование
Для использования 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 — слишком много запросов (более 2 в секунду).