Lingue

L'API di Rently può restituire testi localizzati (messaggi, nomi di catalogo e descrizioni) in base alla lingua di ogni richiesta. La lingua si controlla con il parametro di query ?language=, che ha priorità sul resto della configurazione.

Come richiedere una lingua

Aggiungi il parametro language alla query string di qualsiasi chiamata dell'API. La lingua risolta si applica a quella richiesta.

curl "https://{tenant}.rently.com.ar/api/search?From=2026-07-01T10:00:00&To=2026-07-05T10:00:00&FromPlace=1&language=es-AR" \
  -H "Authorization: Bearer {token}"

note

Il parametro ?language= influisce solo sulle richieste dell'API (rotte /api/). Sul resto delle superfici non ha effetto.

Valori supportati

I valori ammessi non sono una lista fissa: dipendono dalla configurazione di ciascun account (tenant). Per conoscere le lingue abilitate nel tuo account consulta l'endpoint GET /api/languages-info, che restituisce ogni lingua con il suo Name (cultura completa, p. es. es-AR) e il suo TwoLetterISOLanguageName (codice ISO di due lettere, p. es. es).

curl "https://{tenant}.rently.com.ar/api/languages-info" \
  -H "Authorization: Bearer {token}"

Risposta (esempio):

[
  {
    "Name": "en-US",
    "DisplayName": "English (United States)",
    "EnglishName": "English (United States)",
    "NativeName": "English (United States)",
    "ThreeLetterWindowsLanguageName": "ENU",
    "ThreeLetterISOLanguageName": "eng",
    "TwoLetterISOLanguageName": "en"
  },
  {
    "Name": "es-AR",
    "DisplayName": "Spanish (Argentina)",
    "EnglishName": "Spanish (Argentina)",
    "NativeName": "español (Argentina)",
    "ThreeLetterWindowsLanguageName": "ESS",
    "ThreeLetterISOLanguageName": "spa",
    "TwoLetterISOLanguageName": "es"
  }
]

Formati accettati in ?language=

Puoi inviare una qualsiasi di queste due forme:

• Nome di cultura completo: es-AR, en-US, pt.
• Codice ISO di due lettere: es, en.

Se il codice di due lettere corrisponde a più di una cultura abilitata, viene risolta la prima corrispondenza disponibile per il tuo account.

suggerimento

Quando ti serve una localizzazione precisa (formato di paese incluso), usa il nome di cultura completo, per esempio es-AR invece di es.

Lingua predefinita

Se non invii ?language=, l'API risolve la lingua con la configurazione del tuo account. Il valore predefinito del sistema è es-AR, che viene utilizzato quando non c'è nessun'altra preferenza applicabile.

Precedenza

La lingua di ogni richiesta si risolve in questo ordine, dalla maggiore alla minore priorità:

1. ?language= della query, se presente ed è un valore valido per il tuo account. Ha priorità su tutto il resto.
2. Lingua dell'utente autenticato, associata alle credenziali con cui è stato ottenuto il token.
3. Lingua predefinita dell'account (tenant).
4. es-AR come valore finale di fallback.

warning

Se ?language= contiene un valore non abilitato per il tuo account, viene ignorato e l'API continua con il livello di precedenza successivo (lingua dell'utente, lingua dell'account e, infine, es-AR). Un valore non valido non produce un errore: semplicemente non viene applicato.

Esempio completo

Cercare disponibilità richiedendo esplicitamente risposte in spagnolo dell'Argentina:

curl "https://{tenant}.rently.com.ar/api/search?From=2026-07-01T10:00:00&To=2026-07-05T10:00:00&FromPlace=1&language=es-AR" \
  -H "Authorization: Bearer {token}"

Per maggiori dettagli sugli endpoint disponibili, consulta il riferimento dell'API.