STAK Container Exchange
API · для интеграторов

REST API биржи STAK

Подключайте свою TOS-систему, ERP или 1С за рабочий день. JWT-аутентификация, OpenAPI/Swagger на каждом сервисе, webhooks на статусы сделок.

partners@stak.su
Quick start · 3 шага
  1. 1Запросите OTP и обменяйте на JWT — POST /api/auth/request-otp → POST /api/auth/verify-otp
  2. 2Все защищённые эндпоинты ждут заголовок Authorization: Bearer <token>. Подпись HS256, issuer/audience: birzha-ktk / birzha-ktk-api.
  3. 3Нужный сервис → откройте Swagger ниже, попробуйте curl-пример, подключайте через любую HTTP-библиотеку.
curl -X POST https://stak.su/api/auth/request-otp \ -H 'content-type: application/json' \ -d '{"phone": "+79161000001"}'

Сервисы и Swagger

Swagger

User Service

Регистрация, OTP, JWT, KYC юр. лиц, профили компаний.

/api/users · /api/auth · /api/kyc
  • POST /api/auth/request-otp
  • POST /api/auth/verify-otp
  • POST /api/kyc/submit
Swagger

Container Service

Каталог контейнеров: создание, поиск, листинги, медиа.

/api/containers
  • GET /api/containers?city=Москва&size=40ft
  • POST /api/containers
  • POST /api/containers/{id}/listings
Swagger

Terminal Service

Сеть терминалов, слоты, гео-фильтры по странам.

/api/terminals
  • GET /api/terminals?country=RU
  • POST /api/terminals
  • PATCH /api/terminals/{id}
Swagger

Deal Service

RFQ, котировки, сделки, эскроу, нотификации.

/api/rfqs · /api/quotes · /api/deals
  • POST /api/rfqs
  • POST /api/quotes
  • GET /api/quotes/recent
Swagger

Payment Service

Эскроу-проводка через ЮKassa, СБП, refund-flow.

/api/payments
  • POST /api/payments
  • POST /api/payments/{id}/release
  • POST /api/payments/{id}/refund

Готовые коннекторы

Если у вас Solvo.TOS, Navis N4 или 1С:Логистика — подключение занимает 1 рабочий день. Технический менеджер ставит коннектор у вас, мы выдаём sandbox-ключи, через 4 часа уже идёт обмен статусами слотов.

Solvo.TOSNavis N41С:ЛогистикаSAP TMКонтур.Диадок (ЭДО)

Webhooks

Подпишитесь на события — биржа дёрнет ваш URL с подписанным payload'ом. События: quote.created, deal.paid, deal.completed, payment.captured.

Rate limits

1000 req/min на токен в свободном тарифе, 10 000 req/min в enterprise. 429 c Retry-After. Burst до 50/sec.

Хотите интеграцию под ключ?

Технический менеджер выйдет за 24 часа, разберём ваш кейс, дадим sandbox-ключи и пример кода под ваш стек.

partners@stak.su