İş ortağı yüzeyi sözleşmesi Okuma PA-30

Gönderi geçmişi listesi

GET/api/partner/v1/shipments

> Künye: TASK-316; REQ-021 KK-7, DEC-253, DEC-284.

Amaç

Hesabın gönderi geçmişini listelemek. Kapalı küme bilinçli olarak "gönderi geçmişi okuma" der: oluşturma / güncelleme / iptal / onay, etiket ve fiyat teklifi bu yüzeyde rotalanmaz (DEC-284 - etiket bir taşıyıcı belgesidir, bir geçmiş kaydı değil; bu dışlamanın gerekçesi DEC-346 ile ölçüme uydurulmuştur).

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

sayfalanmış gönderi listesi. Kapsamı hesabın tenant'ıdır.

KİŞİSEL VERİ

yanıtın her satırı alıcı (gönderiyi teslim alan kişi) bilgisi taşır: buyer_name, buyer_phone, buyer_email, buyer_address, buyer_city, buyer_district, buyer_tax_number. Bu alanlar listede de döner, yalnız detayda değil. İş ortağı bu veriyi hesap sahibi adına işler ve KVKK karşısında işleyen sıfatındadır. Ölçülen tam yüzey 10-security "İş ortağının eriştiği KİŞİSEL VERİ yüzeyi" bölümündedir.

Hatalar

401, 403 (askıda ya da köken uyuşmazlığı), 429 (Retry-After).

Idempotency-Key

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

kabuk

curl "{{host}}/api/partner/v1/shipments?per_page=25" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"