API использует стандартные HTTP-коды и возвращает описание ошибки в поле message.
| Код | Значение |
|---|---|
| 401 | Токен отсутствует, недействителен или OAuth-клиент не связан с компанией. |
| 403 | Необходимое право отсутствует у токена или отозвано у подключения. |
| 404 | Объект не найден в доступной компании. |
| 409 | Номер платежа сайта уже использован с другими параметрами. |
| 422 | Параметры запроса не прошли проверку. |
| 429 | Превышена допустимая частота запросов. |
| 500 | Внутренняя ошибка сервера. |
Передавайте секрет только разработчику вашей интеграции. При компрометации директор должен перевыпустить секрет или отозвать доступ в разделе «Настройки → Общие → Доступ к REST API».
При превышении лимита или параллельном запросе новой выгрузки API возвращает 429 и заголовок
Retry-After с количеством секунд ожидания. Все новые чтения аккаунта делят лимиты подключения и компании.
Смена токена или создание второго подключения не снимают общий лимит компании. Выполняйте страницы последовательно.