Catalog slots

Method for retrieving slots for catalog display.

Used to show the nearest available delivery time.

Request

POST

/places/nearest_delivery_times

Headers

Name

Description

Authorization*

Type: string

Token received in response to the /security/oauth/token request

Body

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

Name

Description

places*

Type: string[]

List of internal unique store identifiers in the Partner’s system.
Unique store identifier in the Partner’s system.

Responses

200 OK

Averaged slots. The response is expected to be an array of objects

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

Unique store identifier in the Partner’s system.

NearestTimeSlot

Name

Description

end_time*

Type: string

Slot end time in store’s local UTC time, in RFC3339 format with fractional seconds.

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

start_time*

Type: string

Slot start time in store’s local UTC time, in RFC3339 format with fractional seconds.

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

id

Type: integer

Slot ID

Example: 15902

400 Bad Request

Request error. The response is expected to contain an array with an error list object

Body

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

ErrorItem[]

ErrorItem

Name

Description

code*

Type: integer

Numeric error code agreed with Yango Deli.

Example: 400

description*

Type: string

Error description

Example: Description of error

401 Unauthorized

Authorisation failed

Body

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

Name

Description

reason*

Type: string

The reason why authorisation failed.

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

404 Not Found

Resource not found. The response is expected to contain an array with an object from the error list

Body

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

ErrorItem[]

500 Internal Server Error

Internal server errors. The response is expected to contain an array with an object from the error list

Body

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

ErrorItem[]

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