İçeriğe geç
SEVKORA API POST /api/partner/v1/carrier-accounts/{id}/verify v1 Değişiklikler

İş ortağı yüzeyi sözleşmesi Taşıyıcı hesapları PA-63

Kendi-hesap kimliğini doğrulama

POST/api/partner/v1/carrier-accounts/{id}/verify

> Künye: TASK-417; REQ-021 KK-7, REQ-023 AC-6, DEC-364, DEC-345, RISK-098.

Amaç

PA-59'un iş ortağı ikizi. Kayıtlı kimliği taşıyıcıya karşı doğrulamak; sonuç her iki yönde de 200 ve kaydedilir (verified alanı ve verification_status).

Aynı denetleyici

/api/v1in PA-59 ucuyla aynı denetleyiciye bağlıdır.

Yetki

İki kademeli kimlik: X-App-Key + Authorization: Bearer.

ORAN SINIRI iki yüzeyde aynı sayaçtır

hesap sahibi üye ve hesap başına dakikada beş deneme, iş ortağı başına değil. Aşımda 429 ve Retry-After; engellenen deneme ne taşıyıcıya ne deftere ulaşır.

Sözleşmenin geri kalanı PA-59 ile birebir aynıdır

doğrulama hiç yapılamıyorsa 422; taşıyıcı reddi failed ve bir sınıf adıdır, değer taşımaz; başarısız doğrulama verified_at alanını null yapar.

Damganın SINIRI (PA-59 ile aynı)

verified: true yalnızca taşıyıcının KİMLİK ucunun bu bilgileri kabul ettiğini gösterir. Servis yetkisi ve ürün aboneliği yalnızca gönderi uçlarında sınanır; doğrulanmış bir hesap gönderi oluşturma adımında ayrıca reddedilebilir.

Başarı 200

{"data": hesap, "verified": bool, "message": string}.

Hatalar

401, 403, 404, 422, 429.

Idempotency-Key

sözleşmesi yoktur.

kabuk
curl -X POST "{{host}}/api/partner/v1/carrier-accounts/TASIYICI_HESABI_ULID/verify" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"