Zum Hauptinhalt springen

Sprachen

Die Rently API kann lokalisierte Texte (Meldungen, Katalognamen und Beschreibungen) abhängig von der Sprache jeder Anfrage zurückgeben. Die Sprache wird über den Query-Parameter ?language= gesteuert, der Vorrang vor der übrigen Konfiguration hat.

So fordern Sie eine Sprache an​

Fügen Sie den Parameter language an die Query-String eines beliebigen API-Aufrufs an. Die aufgelöste Sprache wird auf diese Anfrage angewendet.

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

Der Parameter ?language= wirkt sich nur auf API-Anfragen aus (Routen /api/). Auf den übrigen Oberflächen hat er keine Wirkung.

Unterstützte Werte​

Die zulässigen Werte sind keine feste Liste: Sie hängen von der Konfiguration jedes Kontos (Mandant) ab. Um die in Ihrem Konto aktivierten Sprachen zu erfahren, fragen Sie den Endpunkt GET /api/languages-info ab, der jede Sprache mit ihrem Name (vollständige Kultur, z. B. es-AR) und ihrem TwoLetterISOLanguageName (zweistelliger ISO-Code, z. B. es) zurückgibt.

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

Antwort (Beispiel):

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

Akzeptierte Formate in ?language=​

Sie können eine der beiden folgenden Formen senden:

  • Vollständiger Kulturname: es-AR, en-US, pt.
  • Zweistelliger ISO-Code: es, en.

Entspricht der zweistellige Code mehr als einer aktivierten Kultur, wird die erste für Ihr Konto verfügbare Übereinstimmung aufgelöst.

Tipp

Wenn Sie eine präzise Lokalisierung benötigen (Länderformat inbegriffen), verwenden Sie den vollständigen Kulturnamen, zum Beispiel es-AR statt es.

Standardsprache​

Wenn Sie ?language= nicht senden, ermittelt die API die Sprache anhand der Konfiguration Ihres Kontos. Der Systemstandard ist es-AR, der verwendet wird, wenn keine andere anwendbare Präferenz vorliegt.

Vorrang​

Die Sprache jeder Anfrage wird in dieser Reihenfolge ermittelt, von höchster zu niedrigster Priorität:

  1. ?language= aus der Query, falls vorhanden und ein für Ihr Konto gültiger Wert. Hat Vorrang vor allem anderen.
  2. Sprache des authentifizierten Benutzers, verknüpft mit den Zugangsdaten, mit denen das Token erlangt wurde.
  3. Standardsprache des Kontos (Mandant).
  4. es-AR als letzter Rückfallwert.
Warnung

Enthält ?language= einen für Ihr Konto nicht aktivierten Wert, wird er ignoriert und die API fährt mit der nächsten Vorrangstufe fort (Benutzersprache, Kontosprache und, zuletzt, es-AR). Ein ungültiger Wert erzeugt keinen Fehler: Er wird einfach nicht angewendet.

Vollständiges Beispiel​

Verfügbarkeit suchen und dabei explizit Antworten auf argentinischem Spanisch anfordern:

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

Weitere Details zu den verfügbaren Endpunkten finden Sie in der API-Referenz.