Проверка емкости постамата
Получение списка свободных ячеек постамата на указанную дату.
Рекомендуется для проверки перед определением даты доставки
POST /auth/postamat/capacity
Инициатор запроса внешняя система
Header parameters
| desc | type | ||
|---|---|---|---|
SST-ECOM-KEY | Ключ авторизации | string | required |
Content-Type | Со значением application/json | string | required |
Request body
| desc | type | ||
|---|---|---|---|
postamatId | Идентификатор постамата | int32 | required |
deliveryDate | Предполагаемая дата доставки | date | required |
parcelSize | Массив с размерами посылки в миллиметрах | object | required |
parcelSize object
| desc | type | ||
|---|---|---|---|
length | Длина коробки, мм | int32 | required |
width | Ширина коробки, мм | int32 | required |
height | Высота коробки, мм | int32 | required |
Пример запроса
shell
curl -X 'POST' \
'https://apim.selftech.ru/test/v4/postamat/auth/postamat/capacity' \
-H 'accept: */*' \
-H 'SST-ECOM-KEY: KEY' \
-H 'Content-Type: application/json' \
-d '{
"postamatId": 1,
"deliveryDate": "2023-06-23",
"parcelSize": {
"length": 100,
"width": 200,
"height": 300
}
}'Коды ответов
200 - OK
Response schema
| desc | type | |
|---|---|---|
{date} | Инофрмация по постмату на запрашиваемую дату | object |
400 - Bad request
Response schema
| desc | type | |
|---|---|---|
message | Сообщение ошибки | string |
resultCode | Ответ сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен; | int32 |
json
{
"message": "Неверный формат запроса",
"resultCode": 3
}401 - Unauthorized
Response schema
| desc | type | |
|---|---|---|
message | Сообщение ошибки | string |
resultCode | Ответ сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен; | int32 |
json
{
"message": "Ошибка авторизации",
"resultCode": 1
}500 - Internal server error
Response schema
| desc | type | |
|---|---|---|
message | Сообщение ошибки | string |
resultCode | Ответ сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен; | int32 |
json
{
"message": "Внутренняя ошибка сервера",
"resultCode": 2
}Описание объектов ответа
{date} object
| desc | type | |
|---|---|---|
total | Количество ячеек данного размера | int8 |
totalCapacity | Количество выделенных ячеек всего | int8 |
isBroken | Признак "Постамат сломан" | bool |
Пример ответа
json
{
"2025-07-31": {
"total": 7,
"totalCapacity": 7,
"isBroken": false
},
"2025-07-29": {
"total": 7,
"totalCapacity": 7,
"isBroken": false
},
"2025-07-30": {
"total": 7,
"totalCapacity": 7,
"isBroken": false
}
}