Idiomas

A API da Rently pode devolver textos localizados (mensagens, nomes de catálogo e descrições) de acordo com o idioma de cada requisição. O idioma é controlado pelo parâmetro de query ?language=, que tem prioridade sobre o resto da configuração.

Como pedir um idioma

Adicione o parâmetro language à query string de qualquer chamada da API. O idioma resolvido é aplicado a essa requisição.

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

observação

O parâmetro ?language= só afeta as requisições da API (rotas /api/). No resto das superfícies não tem efeito.

Valores suportados

Os valores admitidos não são uma lista fixa: dependem da configuração de cada conta (tenant). Para conhecer os idiomas habilitados na sua conta, consulte o endpoint GET /api/languages-info, que devolve cada idioma com seu Name (cultura completa, p. ex. es-AR) e seu TwoLetterISOLanguageName (código ISO de duas letras, p. ex. es).

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

Resposta (exemplo):

[
  {
    "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 aceitos em ?language=

Você pode enviar qualquer uma destas duas formas:

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

Se o código de duas letras corresponder a mais de uma cultura habilitada, resolve-se a primeira correspondência disponível para a sua conta.

dica

Quando precisar de uma localização precisa (formato de país incluído), use o nome de cultura completo, por exemplo es-AR em vez de es.

Idioma padrão

Se você não enviar ?language=, a API resolve o idioma com a configuração da sua conta. O valor padrão do sistema é es-AR, que é utilizado quando não há nenhuma outra preferência aplicável.

Precedência

O idioma de cada requisição é resolvido nesta ordem, da maior à menor prioridade:

1. ?language= da query, se estiver presente e for um valor válido para a sua conta. Tem prioridade sobre todo o resto.
2. Idioma do usuário autenticado, associado às credenciais com as quais o token foi obtido.
3. Idioma padrão da conta (tenant).
4. es-AR como valor final de fallback.

aviso

Se ?language= contiver um valor que não está habilitado para a sua conta, ele é ignorado e a API continua com o nível seguinte de precedência (idioma do usuário, idioma da conta e, por último, es-AR). Um valor inválido não produz um erro: simplesmente não é aplicado.

Exemplo completo

Buscar disponibilidade pedindo explicitamente respostas em espanhol da 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 mais detalhes sobre os endpoints disponíveis, consulte a referência da API.