Sayfa şablonunu yaz

PUT /v1/branding/page-template · izin branding:write

Ortam taslağının Liquid sayfa şablonunu yazar (Startup ya da üstü plan, branding_page_template özelliği). Şablon {{ idp.widget }} yuvasını tam bir kez içermelidir; yazımda sandbox içinde derlenir. Boş dize temizler.

İstek

Alan Tür Zorunlu Açıklama
If-Match başlık evet Taslağın son okunan ETag değeri (hiç yazılmadıysa "0"). Yoksa 428, eskiyse 412.
page_template dize evet En çok 102400 bayt; "" temizler.

Yanıt

200 OK; ortam taslağı ve ETag başlığı. theme yalnız ayarlı jetonları taşır; ayarsız jetonlar platform varsayılanından gelir.

{
  "theme": {"mode": "light", "light": {"color": {"primary": "#0a3d91"}}, "logo_height": 40},
  "css": null,
  "page_template": null,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Hatalar

HTTP code Ne zaman
400 unknown_field Gövdede bilinmeyen alan var ya da gövde JSON nesnesi değil.
403 plan_feature_unavailable Plan bu özelliği içermiyor (plan_feature_unavailable, feature ve required_plan uzantıları). Geliştirme ortamları kapıya takılmaz.
412 precondition_failed If-Match taslağın güncel sürümüyle eşleşmiyor.
422 validation_failed page_template yok ya da null (required) veya çok uzun (too_long).
422 template_forbidden_construct Şablon yasak bir yapı kullanıyor (ör. {% include %} ya da <script>) ya da {{ idp.widget }} tam bir kez geçmiyor.
428 precondition_required If-Match başlığı yok.
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin 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/page-template \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "3"' \
  -d '{"page_template":"<div class=\"shell\">{{ idp.widget }}</div>"}'