Ottenere le sostituzioni di testo
GET /v1/branding/texts/{screen}/{locale} · permesso branding:read
Restituisce le sostituzioni di testo di una schermata e di una lingua della pagina ospitata nell'ambito ambiente, oppure in un ambito applicazione o organizzazione (application_id / org_id). Le chiavi senza sostituzione usano il testo del catalogo integrato. Le sostituzioni diventano attive alla pubblicazione.
Richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
screen |
percorso | sì | Schermata della pagina ospitata (ad es. login, authorize). |
locale |
percorso | sì | Lingua supportata (ad es. en, tr). |
application_id |
query | no | Ambito applicazione (app_…). Senza di esso e senza org_id si usa l'ambito ambiente. |
org_id |
query | no | Ambito organizzazione (org_…). Non combinabile con application_id. |
Risposta
200 OK con tutte le sostituzioni dell'ambito, della schermata e della lingua.
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
Errori
| HTTP | code | Quando |
|---|---|---|
| 404 | not_found |
application_id o org_id non è valido, oppure l'applicazione non esiste in questo ambiente. |
| 422 | validation_failed |
Sono stati indicati sia application_id sia org_id (mutually_exclusive), oppure uno è stato ripetuto (repeated). |
| 401 | unauthenticated |
La credenziale manca, non è valida o è stata revocata. |
| 403 | insufficient_permissions |
La credenziale non ha il permesso richiesto. |
| 429 | rate_limited |
Il limite di frequenza è stato superato; riprovare dopo il periodo Retry-After. |
| 503 | service_unavailable |
Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo Retry-After. |
Esempio
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"