Аутентификация

Передавайте ключ в поле key в теле запроса с form-encoded кодировкой. Аутентификация через заголовки не поддерживается — спецификация v2 использует параметры тела для совместимости с существующими реселлерскими SDK.

Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=services

Отправьте POST с полями формы (application/x-www-form-urlencoded) или JSON-объектом с теми же плоскими именами. Размер тела — не более 32 КБ. Неизвестные параметры игнорируются, а пустое значение считается отсутствующим. Любой другой метод отклоняется с METHOD_NOT_ALLOWED.

Ключ, аккаунт и переключатель API проверяются заново при каждом вызове, поэтому приостановленный аккаунт или отозванный ключ перестаёт работать сразу. Аккаунт должен быть активным, а его адрес электронной почты — подтверждённым.

• 401

  INVALID_KEY

  Invalid API key

  Ключ отсутствует, неверен или отозван. Сначала исправьте запрос.

• 403

  INACTIVE_ACCOUNT

  Account suspended

  Аккаунт приостановлен. Сначала исправьте запрос.

• 403

  EMAIL_UNVERIFIED

  Email verification required

  Адрес электронной почты аккаунта ещё не подтверждён. Сначала исправьте запрос.

• 503

  API_DISABLED

  The API is temporarily disabled

  API отключён на короткое время. Retry-After указывает, когда повторить. Повтор может помочь.

• 405

  METHOD_NOT_ALLOWED

  Use POST

  Запрос не был POST. Сначала исправьте запрос.

• 413

  BODY_TOO_LARGE

  Request body too large

  Тело запроса слишком большое. Сначала исправьте запрос.

key=YOUR_API_KEY&action=balance

{
  "error": "Invalid API key",
  "error_code": "INVALID_KEY",
  "retryable": false
}

Ключи создаются и отзываются в /dashboard/api. Исходный ключ показывается ровно один раз. Сервер хранит односторонний верификатор и короткий несекретный идентификатор, поэтому исходное значение позднее восстановить нельзя.

1. 1

   Максимум 5 активных ключей

   на учётную запись. Старые ключи можно отзывать по отдельности.
2. 2

   Замена без простоя.

   Создайте новый ключ, обновите интеграцию, затем отзовите старый. Новые запросы с отозванным ключом отклоняются.
3. 3

   Нужна активная сессия панели.

   Для создания требуется аутентифицированная сессия панели без режима имперсонации. Дополнительный код из письма или пароль не запрашивается.

Ключ API v3 ограничен документированными действиями и не дает доступа к сеансу панели управления или данным других учетных записей.

• Выводить или переводить баланс.
• Изменять email, пароль или настройки 2FA учётной записи.
• Создавать или отзывать другие ключи API через API.
• Обращаться к административным или модераторским эндпоинтам.