Получить детальную информацию о постамате
В ответе метода содержатся данные с детальной информацией по постамату, а именно:
- Описание постамата
postamats - Описание расположения
locationfind - Изображения постамата
photos - График работы
workScheduleworkTimeProfile - Детальная информация по ячейкам
cells - Виды и размеры доступных ячеек
cellSizes - Наличие дополнительного оборудования
machineEquipment - Глубина постамата мм
depth
GET /auth/postamat/get-by-id
Инициатор запроса внешняя система
Header parameters
| desc | type | ||
|---|---|---|---|
SST-ECOM-KEY | Ключ авторизации | string | required |
Query parameters
| desc | type | ||
|---|---|---|---|
cellsType | Получить ячееки с типом: 0 - все ячейки; 1 - ячейки, пригодные для заклада заказов | int32 | no required |
postamatId | Идентификатор постамата | int32 | required |
Пример запроса
shell
curl -X 'GET' \
'https://apim.selftech.ru/test/v4/postamat/auth/postamat/get-by-id?postamatId=123&cellsType=1'' \
-H 'accept: */*' \
-H 'SST-ECOM-KEY: KEY'Коды ответов
200 - OK
Response schema
| desc | type | |
|---|---|---|
postamats | Детальная информация о постамате | ojects |
400 - Bad request
Response schema
| desc | type | |
|---|---|---|
message | Сообщение ошибки | string |
resultCode | Ответ сервера: 1 - Ошибка авторизации; 2 - Внутренняя ошибка сервера; 3 - Неверный формат запроса; 10 - Маркетплейс не активен; | int32 |
json
{
"message": "Ошибка авторизации",
"resultCode": 1
}401 - Unauthorized
500 - Internal server error
Описание объектов ответа
postamats object
| desc | type | |
|---|---|---|
id | Уникальный идентификатор постамата | int32 |
name | Наименование | string |
workTime | Рабочее расписание (краткое) | string |
workTimeProfile | Профиль рабочего расписания | object |
specialDays | Календарь дней исключений (может быть пустым) | object |
find | Как найти точку | string |
photos | Список url фотографий почтоматов | array |
location | Местоположение | object |
cellSizes | Доступные размеры ячеек данного постамата | array |
machineEquipment | Оборудованиe | object |
cells | Ячейки постамата | array |
active | Постамат активен | boolean |
depth | Глубина постамата мм | int32 |
mos_regestry_id | Идентифиактор постамата в гор. реестре | string |
workTimeProfile object
| desc | type | |
|---|---|---|
id | Уникальный идентификатор постамата | int32 |
name | Наименование | string |
active | Флаг активности расписания | boolean |
lastUpdate | Время последнего обновления записи | datetime |
monday | Информация о времени рабочего дня | object |
tuesday | Информация о времени рабочего дня | object |
wednesday | Информация о времени рабочего дня | object |
thursday | Информация о времени рабочего дня | object |
saturday | Информация о времени рабочего дня | object |
sunday | Информация о времени рабочего дня | object |
everyDay | Информация о времени всех дней (возращается только при отсутвии описании по дням) | object |
preHoliday | Информация о времени всех дней (возращается только при отсутвии описании по дням) | object |
holiday | Информация о времени всех дней (возращается только при отсутвии описании по дням) | object |
specialDays object
| desc | type | |
|---|---|---|
holidays | Праздничные дни | array |
days | Рабочие дни | array |
daysOfExclusion | Дни исключения | array |
location object
| desc | type | |
|---|---|---|
id | Идентификатор локации | int32 |
city | Город | string |
street | Улица | string |
house | Номер дома | string |
building | Строение | string |
housing | Корпус | string |
entrance | Подъезд | string |
officeNum | Номер офиса | string |
route | Информация как доехать до локации | string |
latitude | Широта | double |
Долгота | Долгота | double |
fullAddress | Полный адрес постамата | string |
placeTypeId | Идентификатор места установки 1 - МКД (многоквартирный дом); 2 - Гос.учреждение; 3 - Коммерческий объект; 4 - Улица | int32 |
placeTypeName | Название места установки | string |
cellSizes array
| desc | type | |
|---|---|---|
id | Уникальный идентификатор размера | int32 |
width | Ширина ячейки, мм | int32 |
height | Высота ячейки, мм | int32 |
machineEquipment object
| desc | type | |
|---|---|---|
barcodeScannerEquip | Флаг наличия сканера штрих кода | boolean |
heatedCells | Флаг наличия ячеек с подогревом | boolean |
cooledCells | Флаг наличия ячеек с охлаждением | boolean |
cells array
| desc | type | |
|---|---|---|
sizeId | Уникальный идентификатор размера ячейки | int32 |
cellCode | Код ячейки во внешней системе | string |
sizeId | Идентификатор размера ячейки | int32 |
service | Является ячейка сервисной или обычной для закладки | boolean |
useForDelivery | Ячейка может использоваться для операций доставки | boolean |
cleaningRequire | Требуется ли для ячейки уборка | boolean |
forInventory | Помечена ли ячейка для инвентаризации | boolean |
currentProcess | Текущий процесс: 0 - Нет процесса 1 - Процесс доставки 2 - Процесс аренды 3 - Процесс хранения | int32 |
processState | Статус процесса: 0 - нет процесса 1 - забронирована 2 - занята | int32 |
defectiveController | Контроллер замков не неисправен | boolean |
priority | Приоритет по удобству использования. 0 - самый высокий приоритет | int32 |
frontDoor | Номер дверцы постамата | object |
cellId | Уникальный идентификатор ячейки | object |
frontDoor object
| desc | type | |
|---|---|---|
label | Номер дверцы на постамате | string |
forceBlocking | Принудительная блокировка (запрет любых действий) | boolean |
defective | Дверца неисправна | boolean |
Пример ответа
json
{
"active": true,
"depth": 382,
"workSchedule": {
"workTimeProfile": {
"id": 15,
"name": "Круглосуточно",
"active": true,
"lastUpdate": "2023-12-07T13:09:25.952+0300",
"everyDay": {
"start": "00:00",
"end": "23:59"
}
},
"specialDays": {
"holidays": [
{
"day": "2024-07-04",
"type": 0
}
],
"days": [
{
"start": "09:00",
"end": "18:00",
"date": "2023-06-30",
"nonWorking": true
}
],
"daysOfExclusion": [
{
"date": "2024-01-31"
}
]
},
},
"id": 691,
"name": "691",
"workTime": "Круглосуточно",
"find": "Постамат расположен в здании жилого дома, в подъезде №3.",
"photos": [
"https://static.selftech.ru/files/1d/1de509f127a8554549bc51636040ee23e32a191bf156893a79a98f6632af43dc.jpeg",
"https://static.selftech.ru/files/8a/8a3d36192b24c88fd993a8191f0805eeef624f73d86da24feb0931c77332ee8f.jpeg"
],
"location": {
"id": 817,
"city": "Москва",
"street": "Загорьевский проезд",
"house": "7",
"housing": "1",
"latitude": 55.574691,
"longitude": 37.665165,
"fullAddress": "Россия, Москва, Загорьевский проезд, дом: 7, корпус: 1, подъезд: 3",
"entrance": "3",
"placeTypeId": 1,
"placeTypeName": "МКД",
"route": "Постамат расположен в здании жилого дома, в подъезде №3"
},
"cellSizes": [
{
"id": 30,
"width": 211,
"height": 112
},
{
"id": 31,
"width": 457,
"height": 112
},
{
"id": 32,
"width": 211,
"height": 232
},
{
"id": 34,
"width": 457,
"height": 352
},
{
"id": 35,
"width": 211,
"height": 432
}
],
"machineEquipment": {
"barcodeScannerEquip": true,
"heatedCells": false,
"cooledCells": false
},
"mos_regestry_id": "8338d423-3283-4a18-8338-3e6fd2c01cc9"
}