Hesap profili güncelleme

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

Amaç

Fatura ve iletişim alanlarını güncellemek.

Yetki

İki kademeli kimlik: X-App-Key + Authorization: Bearer. Hesap anahtarı partner-api yeteneği taşır ve tek başına /api/v1e giremez.

Yazılabilir küme (KAPALI)

name, account_type, phone, tax_number, tax_place, address, city, district, neighborhood.

Dışarıda kalanlar ve nedenleri

email - hesabın parola sıfırlama ve sahiplenme kanalıdır; yazabilen taraf hesabı devralabilir, yani iki kademeli kimliğin "iki sırdan biri sızdığında sistem açılmaz" vaadi tam burada kırılırdı. Parola ve 2FA REQ-021 KK-7 dışındadır ve rotalanmaz. partner_code / campaign_code iş ortağının kendi lehine yazabileceği yönlendirme alanlarıdır. monthly_shipment_estimate bir iş tahminidir, fatura bilgisi değil. tenant_id gövdeden gelirse yok sayılır - kapsam bağlamdan çözülür.

PATCH, PUT değildir

gönderilmeyen alan dokunulmadan kalır; açıkça null gönderilen alan temizlenir. İkisi aynı şey değildir.

Mahalle istisnası

mahalle bir il ve ilçe çiftine aittir. İstek city ya da district değerini değiştirip neighborhood alanını taşımıyorsa kayıttaki mahalle temizlenir. neighborhood da gönderilirse (null dahil) gönderilen değer yazılır. Yalnız yazım farkı (büyük ya da küçük harf, Türkçe karakter) ya da aynı ilin eşanlamlı adı (örneğin İçel ile Mersin) bir değişiklik sayılmaz ve mahalleyi korur.

Başarı 200

güncellenmiş profil.

Hatalar

422 (geçersiz alan değeri, örneğin 100 karakteri aşan ya da metin olmayan bir neighborhood). Yazılabilir kümenin dışındaki alanlar isteği reddettirmez: yok sayılır, yanıt 200 döner ve yalnız kümedeki alanlar yazılır. Ayrıca 401, 403 (askıda ya da köken uyuşmazlığı), 429 (Retry-After).

curl -X PATCH "{{host}}/api/partner/v1/account/profile" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ" \
  -d '{"phone":"+90 555 000 00 00","city":"İstanbul","district":"Kadıköy"}'