Получение списка постаматов

В ответе метода содержатся данные с информацией по каждому постамату, а именно:

Описание постамата postamats
Описание расположения location find
Изображения постамата photos
График работы workTime workTimeProfile
Виды и размеры доступных ячеек cellSizes
Наличие дополнительного оборудования machineEquipment
Даты, в которые постамат недоступен для закладки новых заказов dayOffs

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

`GET` /auth/postamat/available

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

Header parameters

	desc	type
`SST-ECOM-KEY`	Ключ авторизации	string	required

Query parameters

	desc	type
`scanner`	Наличие сканера баркодов: true - оснащен false - не оснащен	boolean	no required
`schedule`	Выдача рабочего расписания: true - требуется; false - не требуется	boolean	no required

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

shell

curl -X 'GET' \
  'https://apim.selftech.ru/test/v4/postamat/auth/postamat/available?schedule=true' \
  -H 'accept: */*' \
  -H 'SST-ECOM-KEY: KEY'

Коды ответов

200 - OK

Response schema

	desc	type
`postamats`	Список всех доступных постаматов	array of 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` array

	desc	type
`id`	Уникальный идентификатор постамата	int32
`name`	Наименование	string
`workTime`	Рабочее расписание (краткое)	string
`workTimeProfile`	Профиль рабочего расписания	object
`specialDays`	Календарь дней исключений (может быть пустым)	object
`find`	Как найти точку	string
`photos`	Список url фотографий почтоматов	array
`location`	Местоположение	object
`cellSizes`	Доступные размеры ячеек данного постамата	array
`machineEquipment`	Оборудованиe	object
`dayOffs`	Дни недоступные для загрузки новых заказов в постамат	array
`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

`dayOffs` array

	desc	type
`day`	Дата	string
`reason`	Причина недоступности постамата к загрузке. full - постамат переполнен. broken - постамат сломан	string

Пример ответа

json

{
    "postamats": [
    {
        "id": 17,
        "name": "Московский постамат - Библиотека 94",
        "workTime": "Пн: Выходной, Вт-Сб: 12:00 - 22:00, Вс: 12:00 - 20:00, Санитарный день: Последний вторник каждого месяца",
        "dayOffs": [
            {
                "day": "2024-06-03",
                "reason": "full"
            },
            {
                "day": "2024-06-04",
                "reason": "full"
            }
        ],
        "workTimeProfile": {
            "id": 29,
            "name": "Пн: Выходной, Вт-Сб: 12:00 - 22:00, Вс: 12:00 - 20:00, Санитарный день: Последний вторник каждого месяца",
            "active": true,
            "lastUpdate": "2024-04-26T13:55:30.986+0300",
            "tuesday": {
                "start": "12:00",
                "end": "22:00"
            },
            "wednesday": {
                "start": "12:00",
                "end": "22:00"
            },
            "thursday": {
                "start": "12:00",
                "end": "22:00"
            },
            "friday": {
                "start": "12:00",
                "end": "22:00"
            },
            "saturday": {
                "start": "12:00",
                "end": "22:00"
            },
            "sunday": {
                "start": "12:00",
                "end": "20:00"
            }
        },
        "specialDays": {
            "holidays": [],
            "days": [],
            "daysOfExclusion": [
                {
                    "date": "2024-05-25"
                }
            ]
        },
        "find": "Постамат расположен в здании Библиотека 94 на первом этаже",
        "photos": [
            "https://static.selftech.ru/files/1d/1d490ebce8bea1a40f1eba6588b27ca8e9024a19a6d795dab0f55c206a245623.jpg",
            "https://static.selftech.ru/files/5b/5b65584cd635cc262cb6b01d77e238ca91190c9380c1e1ebae6fd80bdfa3b97c.jpg",
            "https://static.selftech.ru/files/0a/0adb3778d47173c6f5ffabc831a9244a6552727c5a4b549f77ed695e6829cb53.jpg"
        ],
        "location": {
            "id": 522,
            "city": "Москва",
            "street": "улица Аносова",
            "house": "3",
            "housing": "2",
            "route": "Постамат расположен в здании Библиотека 94 на первом этаже",
            "latitude": 55.743335,
            "longitude": 37.75506,
            "fullAddress": "Россия, Москва, улица Аносова, дом: 3, корпус: 2, этаж: 1",
            "placeTypeId": 2,
            "placeTypeName": "Гос. учреждение"
        },
        "cellSizes": [
            {
                "id": 1,
                "width": 385,
                "height": 400
            },
            {
                "id": 2,
                "width": 385,
                "height": 210
            },
            {
                "id": 3,
                "width": 385,
                "height": 150
            },
            {
                "id": 4,
                "width": 190,
                "height": 400
            },
            {
                "id": 5,
                "width": 190,
                "height": 170
            }
        ],
        "machineEquipment": {
            "barcodeScannerEquip": true
        },
        "mos_regestry_id": "8338d423-3283-4a18-8338-3e6fd2c01cc9"
    }
    ]
}

Получение списка постаматов ​

GET /auth/postamat/available ​

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

Коды ответов ​

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

postamats array ​

workTimeProfile object ​

specialDays object ​

location object ​

cellSizes array ​

machineEquipment object ​

dayOffs array ​

Пример ответа ​