İş ortağı yüzeyi sözleşmesi Adresler PA-33

Adres defteri listesi

GET/api/partner/v1/warehouses

> Künye: TASK-391; REQ-021 KK-7, DEC-345.

Amaç

Hesabın gönderici adreslerini listelemek. Gönderi oluşturmak bir gönderici adresi gerektirir, dolayısıyla entegrasyonun ilk adımı burasıdır.

Aynı denetleyici

Bu uçlar /api/v1in adres defteriyle aynı denetleyiciye bağlıdır (DEC-345: kopyalama değil montaj), yani iki yüzey zamanla ayrışamaz. İkinci bir iş mantığı yoktur ve bu mekanik olarak bağlıdır - aynı montaj satırı rota tablosunda tam iki kez geçer (biri v1, biri iş ortağı grubunda)

Yetki

İki kademeli kimlik: X-App-Key + Authorization: Bearer. Hesap anahtarı partner-api yeteneği taşır ve tek başına /api/v1e giremez.

Başarı 200

ada göre sıralı adres listesi. Kapsamı hesabın tenant'ıdır.

Hatalar

401 (tek kimlikle gelen istek), 403 (iş ortağı askıda, hesap askıda ya da köken uyuşmazlığı), 429 (Retry-After).

Idempotency-Key

sözleşmesi yoktur (salt-okuma).

kabuk

curl -X GET "{{host}}/api/partner/v1/warehouses" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"