İş ortağı yüzeyi sözleşmesi Hesap PA-28

Bakiye okuma

GET/api/partner/v1/user/credit

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

Amaç

Hesabın bakiyesini okumak. Uç, v1 /user/credit ile aynı denetleyiciyi kullanır; ikinci bir okuma mantığı yazılmaz.

Kendi hesap gönderisi bakiyeyi DEĞİŞTİRMEZ

(TASK-413; DEC-363): o yolda onay anında bakiyeden hiçbir tutar düşülmez ve iptalde iade oluşmaz, çünkü geri alınacak bir ücret satırı hiç doğmaz. Bu uçtan okunan değer bu yüzden kendi hesap gönderilerinden ETKİLENMEZ; ücret bekleyen tarafın taşıyıcının kendisi olduğunu ortak shipment nesnesindeki billing_mode alanı söyler.

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

bakiye.

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/user/credit" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"