start

Это старая версия документа!


Хостинг Украина 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 — слишком много запросов.
  • start.1608565120.txt.gz
  • Последнее изменение: 3 лет назад
  • zinenko