Получает результат задачи

Возвращает результат выполнения MVRP-задачи.

Request

GET

https://courier.yandex.ru/api/v1/vrs/result/mvrp/{task_id}

Path parameters

Name

Description

task_id*

Type: string

Идентификатор MVRP-задачи.

Query parameters

Name

Description

lang

Type: string

Локаль ответа в формате RFC-3066.

Responses

200 OK

Задача выполнена.

Body

application/json
{
    "id": "string",
    "message": "string",
    "status": {
        "queued": 0,
        "started": 0,
        "completed": 0,
        "cancelled": 0,
        "estimate": 0
    }
}

Name

Description

id*

Type: string

Уникальный id задачи.

status*

Type: task_info_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

message

Type: string

Описание состояния задачи.

task_info_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

Name

Description

queued*

Type: number

Задача поставлена в очередь на выполнение.

cancelled

Type: number

Выполнение задачи отменено пользователем или системой в связи с ошибкой или истечением времени ожидания.

completed

Type: number

Выполнение задачи закончено успешно или с ошибкой.

estimate

Type: number

Оценочное время решения задачи. Оценка может меняться в процессе решения. Оценка верна примерно в 75% случаев (задачи решаются за 5-15 секунд до estimate). Для некоторых задач фактическое время решения может быть больше, чем указано в estimate (обычно, не более чем на 1 минуту).

started

Type: number

Началось выполнение задачи.

201 Created

Началось выполнение задачи.

Body

application/json
{
    "id": "string",
    "message": "string",
    "status": {
        "queued": 0,
        "started": 0,
        "completed": 0,
        "cancelled": 0,
        "estimate": 0
    }
}

Name

Description

id*

Type: string

Уникальный id задачи.

status*

Type: task_info_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

message

Type: string

Описание состояния задачи.

202 Accepted

Задача поставлена в очередь на выполнение.

Body

application/json
{
    "id": "string",
    "message": "string",
    "status": {
        "queued": 0,
        "started": 0,
        "completed": 0,
        "cancelled": 0,
        "estimate": 0
    }
}

Name

Description

id*

Type: string

Уникальный id задачи.

status*

Type: task_info_status

Объект, содержащий изменения статусов задачи. Ключи - статусы, значения - время в формате UNIX timestamp.

Возможные изменения статусов: queued -> started -> (completed или cancelled)

message

Type: string

Описание состояния задачи.

403 Forbidden

У вас нет доступа к этой задаче.

410 Gone

Запрошенная задача не найдена.

Body

application/json
{
    "error": {
        "message": "string",
        "incident_id": "string"
    }
}

Name

Description

error*

Type: error_error

Описание ошибки.

error_error

Описание ошибки.

Name

Description

message*

Type: string

Сообщение с описанием ошибки.

incident_id

Type: string

Уникальный идентификатор инцидента c ошибкой. При ошибке API этот идентификатор может использоваться при анализе проблем.

500 Internal Server Error

Ошибка сервера при обработке задачи.

Body

application/json
{
    "error": {
        "message": "string",
        "incident_id": "string"
    }
}

Name

Description

error*

Type: error_error

Описание ошибки.

Body

text/html
{}