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.
curl "{{base_url}}/carrier-accounts" \
-H "Accept: application/json" \
-H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"