Özel CSS'i yaz

PUT /v1/branding/css · izin branding:write

Ortam taslağının özel CSS'ini yazar (Startup ya da üstü plan, branding_custom_css özelliği). CSS beyaz liste arındırıcısından geçer: yalnız ui_catalog sınıfları (idp-*), izinli özellikler ve değerler; korumalı katman (yasal metin, onay ve erişilebilirlik öğeleri) gizlenemez ya da örtülemez. Hepsi ya da hiç: tek bir ihlal varsa hiçbir şey yazılmaz. Taslağa gönderdiğiniz metin değil, arındırıcının kanonik çıktısı yazılır; yanıttaki css bu çıktıdır. Boş dize temizler ve plan kapısına takılmaz.

İ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.
css dize evet En çok 51200 bayt, geçerli UTF-8; "" 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": ".idp-c .idp-title{color:#0a3d91}\n",
  "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 css yok ya da null (required), çok uzun (too_long) ya da geçersiz UTF-8 (invalid_utf8).
422 branding_validation_failed CSS arındırıcıdan geçmedi. violations uzantısı bütün ihlalleri listeler: line, column (1 tabanlı), rule (ör. class_not_in_catalog, protected_property, property_not_allowed, syntax_error) ve varsa name (özellik, sınıf ya da fonksiyon adı). CSS değeri yanıtta yer almaz. 100 ihlalden sonra arındırıcı durur; son öğe too_many_issues kuralıdır. Kanonik çıktı girdiden uzundur (her kurala kapsam öneki eklenir); 51200 baytı aşarsa tek ihlal satır 1, sütun 1'de too_large kuralıdır.
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.

Arındırıcı reddi örneği:

.idp-button{position:fixed}
.my-banner{color:red}

{
  "type": "https://docs.keenauth.com/errors/branding_validation_failed",
  "title": "Branding validation failed",
  "status": 422,
  "code": "branding_validation_failed",
  "violations": [
    {"line": 1, "column": 13, "rule": "property_not_allowed", "name": "position"},
    {"line": 2, "column": 1, "rule": "class_not_in_catalog", "name": "my-banner"}
  ],
  "request_id": "req_01J9Z3N5W8Q2F6V4K7T1M0XB3C"
}

Örnek

curl -X PUT https://api.eu.keenauth.com/v1/branding/css \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H 'If-Match: "3"' \
  -d '{"css":".idp-title { color: #0a3d91 }"}'