Коды ответов и ошибки

HTTP-коды ответов представлены в таблице.

Значение

Описание

200

Отчет успешно сформирован в режиме онлайн

201

Отчет успешно поставлен в очередь на формирование в режиме офлайн

202

Отчет формируется в режиме офлайн

400

Ошибка в запросе или превышен лимит запросов в очереди

500

Ошибка при формировании отчета на сервере

502

Время обработки запроса превысило серверное ограничение.

В случае ошибки возвращается следующая структура:

{
  "error": {
      "request_id": (string),
      "error_code": (int),
      "error_string": (string),
      "error_detail": (string)
  }
}
<?xml version="1.0" encoding="UTF-8"?>
  <reports:reportDownloadError xmlns:reports="http://api.direct.yandex.com/v5/reports">
  <reports:ApiError>
      <reports:requestId>(string)</reports:requestId>
      <reports:errorCode>(int)</reports:errorCode>
      <reports:errorMessage>(string)</reports:errorMessage>
      <reports:errorDetail>(string)</reports:errorDetail>
  </reports:ApiError>
  </reports:reportDownloadError>

Объект reports:ApiError

Параметр

Тип

Описание

reports:requestId

string

Уникальный идентификатор запроса, присвоенный сервером API Директа. Также передается в HTTP-заголовке RequestId.

reports:errorCode

int

Числовой код ошибки.

reports:errorMessage

string

Текст сообщения об ошибке.

reports:errorDetail

string

Подробное описание ошибки.

Описание ошибок приведено в разделе Ошибки и предупреждения.