Markalama önizleme bağlantısı oluştur
POST /v1/branding:preview-link · izin branding:write
Barındırılan giriş sayfasını ortamın güncel markalama taslaklarıyla, yayımlanmadan önce gösteren bir bağlantı oluşturur. Sayfa her zaman en son taslağı çizer: taslağı değiştirip sayfayı yenilediğinizde değişikliği görürsünüz. Sayfanın üstünde önizleme olduğunu söyleyen bir şerit vardır ve giriş denetimlerinin hepsi kapalıdır. Taslak metin geçersiz kılmaları sayfanın dilinde gösterilir; önizleme şeridini değiştiremezler.
Bağlantı 10 dakika geçerlidir ve geri çağrılamaz; süre dolunca 404 verir. Bağlantıyı bilen herkes taslağı görebilir; yalnız tasarımı inceleyecek kişilerle paylaşın. Bir ortamda aynı anda en çok 20 geçerli bağlantı olabilir.
İstek
Gövde isteğe bağlıdır. Gövde yoksa sayfa yalnız ortam taslağını gösterir.
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
application_id |
string | hayır | Bu uygulamanın taslağını da uygula (app_…). |
org_id |
string | hayır | Bu organizasyonun taslağını da uygula (org_…): logosu ve birincil rengi. |
Yanıt
200 OK. url yalnız bu yanıtta, Cache-Control: no-store ile döner. Aynı Idempotency-Key ile tekrarlanan istek url döndürmez, secret_redacted: true döner; yeni bir bağlantı oluşturun.
{
"url": "https://acme.eu1.keenauth.app/u/preview?token=…",
"expires_at": "2026-10-19T12:10:00Z"
}
Hatalar
| HTTP | code | Ne zaman |
|---|---|---|
| 400 | unknown_field |
Gövdede bilinmeyen bir alan var ya da gövde bir JSON nesnesi değil. |
| 404 | not_found |
Uygulama bu ortamda yok. |
| 422 | validation_failed |
application_id ya da org_id geçerli bir kimlik değil (invalid_value). |
| 401 | unauthenticated |
Kimlik bilgisi eksik, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Kimlik bilgisinin gereken izni yok. |
| 429 | rate_limited |
Ortamda zaten 20 geçerli bağlantı var ya da 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 POST https://api.eu.keenauth.com/v1/branding:preview-link \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"application_id":"app_01jb…"}'
CLI ile:
keenauth branding preview-link --application-id app_01jb…