Markalama sürümlerini listele

GET /v1/branding/versions · izin branding:read

Yayımlanmış sürümleri yeniden eskiye, imleçli sayfalamayla (limit, after) listeler. Yalnız ileri sayfalama vardır; before ve order 422 ile reddedilir. Toplam sayı dönmez.

İstek

Alan Tür Zorunlu Açıklama
limit sorgu hayır Sayfa başına 1-100 öğe.
after sorgu hayır list_metadata.after imleci.

Yanıt

200 OK; data[] (sürüm üst verisi) ve list_metadata.

{"data": [{"version": 4, "snapshot_sha256": "3f1c…", "source": "publish", "rolled_back_from": null,
           "actor_type": "api_key", "actor_id": "key_01jb…", "published_at": "2026-10-05T09:31:00Z"}],
 "list_metadata": {"before": null, "after": "eyJ2Ijo…"}}

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç bozuk ya da başka bir ortama ait.
422 validation_failed limit aralık dışında ya da before/order verildi (unsupported).
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 "https://api.eu.keenauth.com/v1/branding/versions?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"