Textüberschreibungen abrufen

GET /v1/branding/texts/{screen}/{locale} · Berechtigung branding:read

Gibt die Textüberschreibungen eines Bildschirms und einer Sprache der gehosteten Seite im Umgebungsbereich oder in einem Anwendungs- bzw. Organisationsbereich (application_id / org_id) zurück. Schlüssel ohne Überschreibung verwenden den integrierten Katalogtext. Überschreibungen werden beim Veröffentlichen aktiv.

Anfrage

Feld Typ Erforderlich Beschreibung
screen Pfad ja Bildschirm der gehosteten Seite (z. B. login, authorize).
locale Pfad ja Unterstützte Sprache (z. B. en, tr).
application_id Query nein Anwendungsbereich (app_…). Ohne ihn und org_id gilt der Umgebungsbereich.
org_id Query nein Organisationsbereich (org_…). Nicht mit application_id kombinierbar.

Antwort

200 OK mit allen Überschreibungen des Bereichs, Bildschirms und der Sprache.

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

Fehler

HTTP Code Wann
404 not_found application_id oder org_id ist fehlerhaft, oder die Anwendung existiert in dieser Umgebung nicht.
422 validation_failed application_id und org_id wurden zusammen angegeben (mutually_exclusive) oder einer wurde wiederholt (repeated).
401 unauthenticated Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Anmeldeinformation fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; nach der Retry-After-Zeit erneut versuchen.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der Retry-After-Zeit erneut versuchen.

Beispiel

curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"