İçeriğe geç
SEVKORA API GET /api/v1/carrier-accounts v1 Değişiklikler

Public API v1 sözleşmesi Taşıyıcı hesapları PA-12

Taşıyıcı hesapları

GET/api/v1/carrier-accounts

> Künye: TASK-026 (DEC-014); TASK-417 genişletmesi (DEC-364, REQ-023 AC-6).

Amaç

PA-03'ün zorunlu girdisi carrier_account_idnin ve hesap bazlı yeteneklerin keşfi (DEC-014: tüketici, desteklenmeyen işlemi çağırmadan bilebilsin). Liste yalnız AKTİF satırları taşır: PA-60 ile devre dışı bırakılmış bir satır listede yer almaz (satır silinmez). Hesap yönetimi iki yerden yapılır: uygulama içinden ve bu yüzeyin yazma uçlarından (PA-57..PA-60).

Yetki

Bearer anahtar; kapsam anahtarın tenant'ıdır.

Başarı 200

{"data": [hesap, ...]}. Hesap nesnesi: id, name, carrier_code, account_model (own_account: tenant'ın kendi taşıyıcı kimliği; dealer: Sevkora bayi hesabı), environment (sandbox ya da live), status (active; devre dışı satır listede yoktur), verification_status (pending, verified ya da failed), verified_at, verification_error (taşıyıcı reddinin sınıf adı ya da null), credential_fingerprint (müşteri numarasının son dört hanesi ya da null), capabilities (sınıf seviyesi yetenek listesi; kayıtsız carrier_code boş liste döner, fail-closed) ve is_sandbox. is_sandbox geriye uyumluluk için KALIR (v1 içinde alan kaldırılmaz) ve environment ile aynı gerçeği söyler; yeni tüketici environment okumalıdır. credentials hiçbir yanıta giremez.

Hatalar

401, 429.

kabuk
curl "{{base_url}}/carrier-accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"