Saltar al contenido principal

Idiomas

La API de Rently puede devolver textos localizados (mensajes, nombres de catálogo y descripciones) según el idioma de cada petición. El idioma se controla con el parámetro de query ?language=, que tiene prioridad sobre el resto de la configuración.

Cómo pedir un idioma

Agregá el parámetro language a la query string de cualquier llamada de la API. El idioma resuelto se aplica a esa petición.

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

El parámetro ?language= solo afecta a las peticiones de la API (rutas /api/). En el resto de las superficies no tiene efecto.

Valores soportados

Los valores admitidos no son una lista fija: dependen de la configuración de cada cuenta (tenant). Para conocer los idiomas habilitados en tu cuenta consultá el endpoint GET /api/languages-info, que devuelve cada idioma con su Name (cultura completa, p. ej. es-AR) y su TwoLetterISOLanguageName (código ISO de dos letras, p. ej. es).

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

Respuesta (ejemplo):

[
{
"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"
}
]

Formatos aceptados en ?language=

Podés enviar cualquiera de estas dos formas:

  • Nombre de cultura completo: es-AR, en-US, pt.
  • Código ISO de dos letras: es, en.

Si el código de dos letras corresponde a más de una cultura habilitada, se resuelve la primera coincidencia disponible para tu cuenta.

tip

Cuando necesites una localización precisa (formato de país incluido), usá el nombre de cultura completo, por ejemplo es-AR en lugar de es.

Idioma por defecto

Si no enviás ?language=, la API resuelve el idioma con la configuración de tu cuenta. El valor por defecto del sistema es es-AR, que se utiliza cuando no hay ninguna otra preferencia aplicable.

Precedencia

El idioma de cada petición se resuelve en este orden, de mayor a menor prioridad:

  1. ?language= de la query, si está presente y es un valor válido para tu cuenta. Tiene prioridad sobre todo lo demás.
  2. Idioma del usuario autenticado, asociado a las credenciales con las que se obtuvo el token.
  3. Idioma por defecto de la cuenta (tenant).
  4. es-AR como valor final de respaldo.
aviso

Si ?language= contiene un valor que no está habilitado para tu cuenta, se ignora y la API continúa con el siguiente nivel de precedencia (idioma del usuario, idioma de la cuenta y, por último, es-AR). Un valor inválido no produce un error: simplemente no se aplica.

Ejemplo completo

Buscar disponibilidad pidiendo explícitamente respuestas en español de 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}"

Para más detalles sobre los endpoints disponibles, consultá la referencia de la API.