InLog Postomat

InLog Postomat — сеть постоматов. Интеграционный API позволяет вашей системе:

• находить постоматы по городу, району или координатам и смотреть свободные ячейки;
• создавать заявки на доставку посылки в постомат для конкретного получателя;
• получать коды закладки, получения и изъятия посылки;
• отслеживать статус заявки запросами к API и получать уведомления о смене статуса на свой URL.

Получить API-ключ

Окружения

Окружение	Хост
Продакшн	https://postomat-api-1.inlog.ai
Тестовое	http://api.test.postomat.inlog.ai

Базовый путь интеграционного API:

{host}/api/v1/integration/company

Все пути в этом разделе указаны относительно базового пути. Например, POST /order/create на продакшне — это POST https://postomat-api-1.inlog.ai/api/v1/integration/company/order/create.

Тестовое окружение

Отлаживайте интеграцию на тестовом окружении. Токен для него запрашивается отдельно, так же как и для продакшна.

Основной сценарий

1. Найдите постомат — Постоматы и ячейки.
2. Создайте заявку на получателя — Заявки.
3. Передайте курьеру код закладки (down-code). Получатель забирает посылку по коду получения (up-code).
4. Отслеживайте статус — Статусы заявки и Вебхуки.

Авторизация

Каждый запрос к интеграционному API передаёт токен компании в заголовке:

Authorization: Bearer YOUR_API_KEY

Подробнее — в разделе Авторизация.

SDK

Язык	Пакет	Документация
Node.js (18+)	@inlog-sdk/postomat	SDK Node.js
Java (8+)	ai.inlog.sdk:postomat-java	SDK Java

Оба SDK по умолчанию обращаются к продакшн-хосту; для тестового окружения укажите базовый URL явно.

Swagger UI

Интерактивное описание API доступно по пути /docs на хосте API, например http://api.test.postomat.inlog.ai/docs. В нём перечислены все эндпоинты сервиса; для интеграции используйте только те, что описаны в этом разделе.