Langues

L'API de Rently peut renvoyer des textes localisés (messages, noms de catalogue et descriptions) selon la langue de chaque requête. La langue se contrôle avec le paramètre de query ?language=, qui a priorité sur le reste de la configuration.

Comment demander une langue

Ajoutez le paramètre language à la query string de n'importe quel appel de l'API. La langue résolue s'applique à cette requête.

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

remarque

Le paramètre ?language= n'affecte que les requêtes de l'API (routes /api/). Sur les autres surfaces, il n'a aucun effet.

Valeurs supportées

Les valeurs admises ne sont pas une liste fixe : elles dépendent de la configuration de chaque compte (tenant). Pour connaître les langues activées sur votre compte, consultez l'endpoint GET /api/languages-info, qui renvoie chaque langue avec son Name (culture complète, p. ex. es-AR) et son TwoLetterISOLanguageName (code ISO à deux lettres, p. ex. es).

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

Réponse (exemple) :

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

Formats acceptés dans ?language=

Vous pouvez envoyer l'une de ces deux formes :

• Nom de culture complet : es-AR, en-US, pt.
• Code ISO à deux lettres : es, en.

Si le code à deux lettres correspond à plusieurs cultures activées, la première correspondance disponible pour votre compte est retenue.

astuce

Lorsque vous avez besoin d'une localisation précise (format pays inclus), utilisez le nom de culture complet, par exemple es-AR au lieu de es.

Langue par défaut

Si vous n'envoyez pas ?language=, l'API résout la langue à partir de la configuration de votre compte. La valeur par défaut du système est es-AR, utilisée lorsqu'aucune autre préférence n'est applicable.

Précédence

La langue de chaque requête est résolue dans cet ordre, du plus prioritaire au moins prioritaire :

1. ?language= de la query, s'il est présent et qu'il s'agit d'une valeur valide pour votre compte. Il a priorité sur tout le reste.
2. Langue de l'utilisateur authentifié, associée aux identifiants avec lesquels le token a été obtenu.
3. Langue par défaut du compte (tenant).
4. es-AR comme valeur de repli finale.

attention

Si ?language= contient une valeur qui n'est pas activée pour votre compte, elle est ignorée et l'API poursuit avec le niveau de précédence suivant (langue de l'utilisateur, langue du compte et, en dernier lieu, es-AR). Une valeur invalide ne produit pas d'erreur : elle n'est simplement pas appliquée.

Exemple complet

Rechercher la disponibilité en demandant explicitement les réponses en espagnol d'Argentine :

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

Pour plus de détails sur les endpoints disponibles, consultez la référence de l'API.