Слоты в каталоге

Метод получения слотов для каталога.

Используются для отображения ближайшего возможного времени доставки.

Важно

Время в слотах нужно указывать по времени магазина, а не по UTC, при этом передав временную зону магазина.
Например, если магазин находится в Армении и вы хотите передать слот с 10:00 до 12:00 по местному времени, то нужно передавать время
в формате RFC3339: 2022-05-18T10:00:00+04:00 и 2022-05-18T12:00:00+04:00 соответственно.

Request

POST

/places/nearest_delivery_times

Headers

Name

Description

Authorization*

Type: string

Токен, полученный в ответе на запрос /security/oauth/token

Body

application/json
{
    "places": [
        "string"
    ]
}

Name

Description

places*

Type: string[]

Список внутренних уникальных идентификаторов магазинов в системе партнёра.
Уникальный идентификатор магазина в системе Партнёра.

Responses

200 OK

Усредненные слоты. В ответе ожидается массив объектов

Body

application/json
[
    {
        "nearest_times": [
            {
                "end_time": "2022-05-18T16:05:27.000000+03:00",
                "id": 15902,
                "start_time": "2022-05-18T15:35:27.000000+03:00"
            }
        ],
        "placeId": "string"
    }
]

NearestSlotItem[]

NearestSlotItem

Name

Description

nearest_times*

Type: NearestTimeSlot[]

placeId*

Type: string

Уникальный идентификатор магазина в системе Партнёра.

NearestTimeSlot

Name

Description

end_time*

Type: string

Время окончания слота, по времени магазина, в формате RFC3339 с дробной частью секунд.

Example: 2022-05-18T16:05:27.000000+03:00

start_time*

Type: string

Время старта слота, по времени магазина, в формате RFC3339 с дробной частью секунд.

Example: 2022-05-18T15:35:27.000000+03:00

id

Type: integer

Идентификатор слота

Example: 15902

400 Bad Request

Ошибка в запросе. В ответе ожидается массив с объектом списка ошибок

Body

application/json
[
    {
        "code": 400,
        "description": "Description of error"
    }
]

ErrorItem[]

ErrorItem

Name

Description

code*

Type: integer

Согласованный с Яндекс Едой числовой код ошибки.

Example: 400

description*

Type: string

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

Example: Description of error

401 Unauthorized

Не пройдена авторизация

Body

application/json
{
    "reason": "Access token has been expired. You should request a new one"
}

Name

Description

reason*

Type: string

Причина, по которой не прошла авторизация.

Example: Access token has been expired. You should request a new one

404 Not Found

Не найден ресурс. В ответе ожидается массив с объектом из списка ошибок

Body

application/json
[
    {
        "code": 400,
        "description": "Description of error"
    }
]

ErrorItem[]

500 Internal Server Error

Внутренние ошибки сервера. В ответе ожидается массив с объектом из списка ошибок

Body

application/json
[
    {
        "code": 400,
        "description": "Description of error"
    }
]

ErrorItem[]

No longer supported, please use an alternative and newer version.