Skip to content

Проверка емкости постамата

Получение списка свободных ячеек постамата на указанную дату.

Рекомендуется для проверки перед определением даты доставки

POST /auth/postamat/capacity

Инициатор запроса внешняя система

Header parameters

desctype
SST-ECOM-KEYКлюч авторизацииstringrequired
Content-TypeСо значением application/jsonstringrequired

Request body

desctype
postamatIdИдентификатор постаматаint32required
deliveryDateПредполагаемая дата доставкиdaterequired
parcelSizeМассив с размерами посылки в миллиметрахobjectrequired

parcelSize object

desctype
lengthДлина коробки, ммint32required
widthШирина коробки, ммint32required
heightВысота коробки, ммint32required

Пример запроса

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

desctype
{date}Инофрмация по постмату на запрашиваемую датуobject
400 - Bad request

Response schema

desctype
messageСообщение ошибкиstring
resultCodeОтвет сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен;int32
json
{
"message": "Неверный формат запроса",
"resultCode": 3
}
401 - Unauthorized

Response schema

desctype
messageСообщение ошибкиstring
resultCodeОтвет сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен;int32
json
{
"message": "Ошибка авторизации",
"resultCode": 1
}
500 - Internal server error

Response schema

desctype
messageСообщение ошибкиstring
resultCodeОтвет сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен;int32
json
{
"message": "Внутренняя ошибка сервера",
"resultCode": 2
}

Описание объектов ответа

{date} object

desctype
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
    }
}