E-SadarakРазработчикам
enazru

Партнёрский API

Интегрируйте грузоперевозки, платежи и витрины с Садараком

Версионированный REST API (/v1), где источник истины — спецификация OpenAPI. Аутентификация по телефону и OTP уже работает; партнёрские эндпоинты, API-ключи и вебхуки появятся на этапе 5.

Открыть справочник APIСкачать openapi.json

Что предлагает API

  • Каталог

    Категории, поиск товаров на az/ru/en и страницы продавцов из тысяч павильонов Садарака.

  • Заказы и отслеживание

    Создавайте заказы от имени клиентов и следите за хронологией статусов от PLACED до DELIVERED.

  • Логистические партнёры

    Грузовые и платёжные партнёры подключаются через /v1/partner с аутентификацией по API-ключу и лимитами по скоупам.

  • Вебхуки

    События order.delivered и batch.completed, подписанные HMAC, чтобы вы могли проверить каждую доставку.

Доступность

Доступно сейчас

Проверка состояния и аутентификация по телефону и OTP (/v1/auth/*).

Этап 5

Партнёрские эндпоинты, самообслуживание API-ключей, настройка вебхуков и журналы доставок, песочница.

Соглашения

  • Все суммы — целые числа в гяпиках (минорные единицы AZN); поля оканчиваются на Qepik.
  • Ошибки — JSON со стабильным кодом (ERR_*), никогда не локализованный текст.
  • Номера телефонов в формате E.164 (+994XXXXXXXXX). Access-токен живёт 15 минут, refresh-токен — 30 дней.
  • Обновления в реальном времени через Socket.IO, пространство имён /realtime, access-токен в handshake.