Metin geçersiz kılmalarını ayarla

PUT /v1/branding/texts/{screen}/{locale} · izin branding:write

Bir ekran ve dil için metin geçersiz kılmalarını yazar; gövdedeki anahtarlar eklenir veya değiştirilir, diğer anahtarlar korunur. Yalnızca yerleşik kataloğun anahtarları geçersiz kılınabilir ve bir değer, katalog metninin {{ placeholders }} ifadelerini korumalıdır. Denetim ve çift yönlü denetim karakterleri reddedilir. Güvenlik metinleri geçersiz kılınamaz: onay ekranı, cihaz ve çıkış yap onayı, kurtarma kodu uyarısı ve önizleme başlığı. Yayımlandığında etkili olur.

İstek

Alan Tür Zorunlu Açıklama
screen path evet Barındırılan sayfa ekranı (ör. login, authorize).
locale path evet Desteklenen dil (ör. en, tr).
application_id query hayır Uygulama kapsamı (app_…). Bu ve org_id verilmezse ortam kapsamı kullanılır.
org_id query hayır Kuruluş kapsamı (org_…). application_id ile birlikte kullanılamaz.
texts object evet Anahtar → değer, 1-500 anahtar, her değer 1-1000 karakter.

Yanıt

200 OK, kapsamın, ekranın ve dilin tüm geçersiz kılmalarıyla birlikte.

{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}

Hatalar

HTTP code Ne zaman
400 unknown_field Gövdede bilinmeyen bir alan var veya JSON nesnesi değil.
404 not_found application_id veya org_id hatalı biçimde, ya da uygulama bu ortamda yok.
422 validation_failed texts eksik veya boş, bir anahtar bilinmiyor (unknown_text_key), bir placeholder eksik (placeholder_mismatch), dil desteklenmiyor veya bir değer geçersiz; pointer değeri /texts/<key> şeklindedir. Hem application_id hem org_id verildi (mutually_exclusive) ya da biri tekrarlandı (repeated).
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -X PUT "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texts":{"title":"Hoş geldiniz"}}'