Public API v1 sözleşmesi Bakiye PA-65

Bakiye okuma

GET/api/v1/user/credit

> Künye: TASK-038 B1 (uç), TASK-482 (bu sayfa); REQ-006, DEC-028, DEC-037, DEC-465.

Amaç

Ön ödemeli bakiyenin o andaki değerini okumak. SALT OKUMA ve yan etkisiz (CQS): cüzdan satırı oluşturulmaz; hiç yükleme yapılmamış bir hesapta uç sıfır döner. Idempotency-Key sözleşmesi yoktur.

Uç TASK-038 B1'den beri yayımdadır; yazılmamış olan bu SAYFAYDI

(TASK-482; DEC-465). Sonucu görünürden ağırdı: iş ortağı ikizi PA-28 yazılı olduğu hâlde v1 sayfası bulunmadığı için portal artefaktında çift oluşmuyor, ikiz yol tablosu bu yolu istemiyor ve tabloyu iki yönde ölçen sözleşme testi iki yanını da aynı artefakttan okuduğu için boşluğu göremiyordu: boş küme üzerinde yeşil dönen bir kapı. Sayfa yazıldığı an çift oluşur ve kapı bu yol üzerinde de ısırır.

Yetki

Bearer anahtar (public-api yeteneği); değer anahtarın tenant'ına sunucu tarafında sınırlanır, yani başka tenant'ın bakiyesi görünmez.

Başarı 200

{"balance_minor": 125000, "currency": "TRY"}. balance_minor tam sayı kuruştur (08-api "Kimlikler, tarihler, sayılar"); ondalık bir değer değildir ve öyle okunmamalıdır.

Kendi hesap gönderisi bu değeri 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. Ücret bekleyen tarafın taşıyıcının kendisi olduğunu ortak shipment nesnesindeki billing_mode alanı söyler.

Hatalar

401, 429 (Retry-After).

kabuk

curl "{{base_url}}/user/credit" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"