Проверить готовность отчета
Возвращает текущий статус задачи. Опрашивайте этот метод, пока статус не станет SUCCESS, FAILURE или EXPIRED.
GET /api/v2/reports/{taskId}
Возможные статусы: PENDING → RUNNING → SUCCESS / FAILURE / EXPIRED.
|
Параметр |
Описание |
|
|
path, строка — значение из |
Успешный ответ (HTTP 200)
|
Поле |
Тип |
Описание |
|
|
object |
|
|
|
string |
Идентификатор задачи. |
|
|
string |
Одно из: |
|
|
object |
Только при |
Объект result.error
|
Поле |
Тип |
Описание |
|
|
string |
При |
|
|
string |
Пояснение, часто |
Смысл result.status
|
Значение |
Смысл для клиента |
|
|
Ожидает в очереди. |
|
|
Выполняется. |
|
|
Отчет успешно построен; можно запрашивать |
|
|
Ошибка построения; смотрите |
|
|
Результат устарел / отозван; полный результат через |
Пример запроса
curl -H 'Authorization: OAuth <токен>' \
'https://adfox.yandex.ru/api/v2/reports/umr-a-rsr-b5555555-5555-5555-5555-555555555501'
Пример ответа (HTTP 200)
{
"result": {
"taskId": "umr-a-rsr-b5555555-5555-5555-5555-555555555501",
"status": "SUCCESS"
}
}
Ошибки
С кодами ошибок можно ознакомиться на странице Коды ошибок.