Définir les remplacements de textes

PUT /v1/branding/texts/{screen}/{locale} · autorisation branding:write

Enregistre les remplacements de textes pour un écran et une langue donnés ; les clés présentes dans le corps sont ajoutées ou remplacées, les autres clés sont conservées. Seules les clés du catalogue intégré peuvent être remplacées, et une valeur doit conserver les {{ placeholders }} du texte du catalogue. Les caractères de contrôle et les caractères de contrôle bidirectionnels sont rejetés. Les textes de sécurité ne peuvent pas être remplacés : l'écran de consentement, la confirmation d'appareil et de déconnexion, l'avertissement relatif au code de récupération et la bannière d'aperçu. Les modifications prennent effet à la publication.

Requête

Champ Type Obligatoire Description
screen chemin oui Écran de la page hébergée (par exemple login, authorize).
locale chemin oui Langue prise en charge (par exemple en, tr).
application_id requête non Périmètre de l'application (app_…). Sans lui et sans org_id, le périmètre de l'environnement est utilisé.
org_id requête non Périmètre de l'organisation (org_…). Ne peut pas être combiné avec application_id.
texts objet oui Clé → valeur, de 1 à 500 clés, chaque valeur comptant de 1 à 1000 caractères.

Réponse

200 OK avec chaque remplacement du périmètre, de l'écran et de la langue.

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

Erreurs

HTTP code Quand
400 unknown_field Le corps contient un champ inconnu ou n'est pas un objet JSON.
404 not_found La valeur de application_id ou org_id est mal formée, ou l'application n'existe pas dans cet environnement.
422 validation_failed texts est absent ou vide, une clé est inconnue (unknown_text_key), un placeholder manque (placeholder_mismatch), la langue n'est pas prise en charge ou une valeur est invalide ; pointer vaut /texts/<key>. Les deux paramètres application_id et org_id ont été fournis (mutually_exclusive), ou l'un d'eux a été répété (repeated).
401 unauthenticated Les identifiants sont absents, invalides ou révoqués.
403 insufficient_permissions Les identifiants ne disposent pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après le délai indiqué dans Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après le délai indiqué dans Retry-After.

Exemple

curl -X PUT "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texts":{"title":"Hoş geldiniz"}}'