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

Kendi-hesap satırı güncelleme

PATCH/api/v1/carrier-accounts/{id}

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

Amaç

Kısmi güncelleme. Gönderilen alan değişir, gönderilmeyen dokunulmaz: name, environment (confirm_live ile birlikte), credentials (verilirse dört alan birlikte ve tamamen değişir; parça parça ezme yoktur).

Kimlik ya da ortam değişimi satırı yeniden `pending`e düşürür

ve taşıyıcı oturumu için tutulan önbelleği temizler; değiştirilmiş kimlik PA-59 ile doğrulanana kadar sevk yolunda kullanılmaz. Yalnız ad değişimi bir etiket değişimidir, doğrulamayı korur.

Yetki

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

Kurallar

boş gövde 422 errors.account; devre dışı satır 422 errors.status; aynı ad 422 errors.name; başka tenant'ın satırı 404 (varlık sızdırılmaz); biçimsiz kimlik 404.

Yan etkiler

PA-57 ile aynı: denetim defteri satırı ve tüm üyelere bildirim. Hiçbir yanıt kimlik değeri taşımaz.

Başarı 200

{"data": hesap}.

Hatalar

401, 404, 422, 429.

Idempotency-Key

sözleşmesi yoktur.

kabuk

curl -X PATCH "{{base_url}}/carrier-accounts/TASIYICI_HESABI_ULID" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ" \
  -d '{"name":"MNG hesabim (guncel)"}'