Obtenir les textes personnalisés
GET /v1/branding/texts/{screen}/{locale} · permission branding:read
Renvoie les textes personnalisés d'un écran et d'une langue de page hébergée dans la portée environnement, ou dans une portée application ou organisation (application_id / org_id). Les clés sans personnalisation utilisent le texte du catalogue intégré. Les personnalisations deviennent actives à la publication.
Requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
screen |
chemin | oui | Écran de la page hébergée (p. ex. login, authorize). |
locale |
chemin | oui | Langue prise en charge (p. ex. en, tr). |
application_id |
query | non | Portée application (app_…). Sans lui ni org_id, la portée environnement est utilisée. |
org_id |
query | non | Portée organisation (org_…). Ne peut pas être combiné avec application_id. |
Réponse
200 OK avec tous les textes personnalisés de la portée, de l'écran et de la langue.
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 404 | not_found |
application_id ou org_id est mal formé, ou l'application n'existe pas dans cet environnement. |
| 422 | validation_failed |
application_id et org_id ont été fournis ensemble (mutually_exclusive), ou l'un a été répété (repeated). |
| 401 | unauthenticated |
L'identifiant est absent, invalide ou révoqué. |
| 403 | insufficient_permissions |
L'identifiant n'a pas la permission requise. |
| 429 | rate_limited |
La limite de débit est dépassée ; réessayez après le délai Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez après le délai Retry-After. |
Exemple
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"