Metadatanızı güncelleyin

PATCH /fapi/v1/me/metadata · environment'ın giriş ana bilgisayarından çağrılır

Kimliği doğrulanmış kullanıcının user_metadata alanına RFC 7396 birleştirme yaması uygular. app_metadata buradan yazılamaz. Sonuç en fazla 16 KiB, derinlik 5 ve en üst düzeyde 100 anahtar olabilir. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; yakın zamanda yeniden doğrulama gerekmez. Farklı bir kökenden gelen birinci taraf uygulama, bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön yüz API erişim belirteci).

İstek

Üstbilgiler:

Üstbilgi Zorunlu Açıklama
Idp-Client evet SDK tanımlayıcısı.
Origin evet Tam olarak https://<giriş ana bilgisayarı> olmalıdır.
If-Match hayır İsteğe bağlı. Önceki bir yanıtın ETag değeri (veya *); değişiklik yalnızca profil hâlâ bu sürümdeyse yapılır.

Gövde (application/merge-patch+json veya application/json): birleştirme yamasının kendisi, bir JSON nesnesi. null olarak ayarlanan bir anahtar kaldırılır; iç içe nesneler birleştirilir.

{
  "theme": null,
  "preferences": {
    "newsletter": false
  }
}

Yanıt

200 OK ile güncellenmiş profil (GET /fapi/v1/me ile aynı alanlar) ve yeni bir ETag.

Hatalar

Durum Kod Ne zaman
400 malformed_request Gövde bir JSON nesnesi değilse veya If-Match üstbilgisi hatalıysa.
401 unauthenticated Geçerli bir oturum çerezi yoksa.
403 origin_not_allowed Origin eksikse veya yanlışsa.
404 not_found Hesap okunamıyorsa (örneğin engellenmişse veya silinmekteyse).
412 precondition_failed If-Match mevcut sürümle eşleşmiyorsa; hiçbir şey değişmez.
413 payload_too_large Gövde 16 KiB'ı aşıyorsa.
415 unsupported_media_type Content-Type desteklenmiyorsa.
422 validation_failed Yama boşsa veya sonuç bir sınırı aşıyorsa (too_large, too_many_keys; işaretçi gövdenin kökü olur).
503 service_unavailable Kullanıcı dizini geçici olarak kullanılamıyorsa; Retry-After saniye sonra yeniden deneyin.

Örnek

curl -X PATCH https://example.keenauth.app/fapi/v1/me/metadata \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/merge-patch+json" \
  -b cookies.txt \
  -d '{"theme":null}'

Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.