Imposta le sostituzioni dei testi

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

Scrive le sostituzioni dei testi per una schermata e una lingua; le chiavi nel corpo vengono aggiunte o sostituite, le altre chiavi vengono mantenute. Si possono sostituire solo le chiavi del catalogo integrato, e un valore deve mantenere i {{ placeholders }} del testo di catalogo. I caratteri di controllo e di controllo bidirezionali vengono rifiutati. I testi di sicurezza non possono essere sostituiti: la schermata di consenso, la conferma di dispositivo e disconnessione, l'avviso sui codici di recupero e il banner di anteprima. Ha effetto alla pubblicazione.

Richiesta

Campo Tipo Obbligatorio Descrizione
screen path sì Schermata della pagina ospitata (ad es. login, authorize).
locale path sì Lingua supportata (ad es. en, tr).
application_id query no Ambito dell'applicazione (app_…). Senza questo e org_id viene usato l'ambito dell'ambiente.
org_id query no Ambito dell'organizzazione (org_…). Non può essere combinato con application_id.
texts object sì Chiave → valore, da 1 a 500 chiavi, ogni valore da 1 a 1000 caratteri.

Risposta

200 OK con ogni sostituzione dell'ambito, della schermata e della lingua.

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

Errori

HTTP code Quando
400 unknown_field Il corpo contiene un campo sconosciuto o non è un oggetto JSON.
404 not_found application_id o org_id non è valido, oppure l'applicazione non esiste in questo ambiente.
422 validation_failed texts manca o è vuoto, una chiave è sconosciuta (unknown_text_key), un placeholder manca (placeholder_mismatch), la lingua non è supportata o un valore non è valido; pointer è /texts/<key>. Sono stati forniti sia application_id sia org_id (mutually_exclusive), oppure uno dei due è stato ripetuto (repeated).
401 unauthenticated La credenziale manca, non è valida o è revocata.
403 insufficient_permissions La credenziale non ha l'autorizzazione richiesta.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo indicato in Retry-After.
503 service_unavailable Una dipendenza non è disponibile temporaneamente; riprova dopo il periodo indicato in Retry-After.

Esempio

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"}}'