E-SadarakTərtibatçılar
enazru

Partnyor API

Yük daşıma, ödəniş və vitrinlərinizi Sədərəklə inteqrasiya edin

OpenAPI spesifikasiyası əsas mənbə olan versiyalı REST API (/v1). Telefon-OTP autentifikasiyası artıq işləyir; partnyor endpointləri, API açarları və vebhuklar 5-ci mərhələdə gəlir.

API arayışını açopenapi.json faylını yüklə

API nə təklif edir

  • Kataloq

    Minlərlə Sədərək köşkündən kateqoriyalar, az/ru/en məhsul axtarışı və satıcı səhifələri.

  • Sifarişlər və izləmə

    Müştərilər adından sifariş yaradın və PLACED-dən DELIVERED-ə qədər status xronologiyasını izləyin.

  • Logistika partnyorları

    Yük və ödəniş partnyorları API açarı ilə autentifikasiya və əhatə dairəsi üzrə sorğu limitləri ilə /v1/partner altında qoşulur.

  • Vebhuklar

    Hər çatdırılmanı yoxlaya bilməniz üçün HMAC ilə imzalanmış order.delivered və batch.completed hadisələri.

Mövcudluq

İndi mövcuddur

Sağlamlıq yoxlaması və telefon-OTP autentifikasiyası (/v1/auth/*).

5-ci mərhələ

Partnyor endpointləri, API açarlarının özünəxidməti, vebhuk konfiqurasiyası və çatdırılma jurnalları, sandbox mühiti.

Qaydalar

  • Bütün məbləğlər qəpiklə tam ədədlərdir (AZN xırda vahidi); sahələr Qepik ilə bitir.
  • Xətalar sabit kodlu (ERR_*) JSON-dur və heç vaxt lokallaşdırılmış mətn deyil.
  • Telefon nömrələri E.164 formatındadır (+994XXXXXXXXX). Giriş tokenləri 15 dəqiqə, yeniləmə tokenləri 30 gün etibarlıdır.
  • Real vaxt yeniləmələri Socket.IO /realtime namespace-i üzərindən, giriş tokeni handshake-də.