Den Kontext vorbereiten

Bevor Sie Verfügbarkeiten suchen und Buchungen erstellen, sollten Sie den Kontext des Mandanten laden: welche Sprachen und Währungen er unterstützt, an welchen Orten er operiert und mit welchen Öffnungszeiten. Diese Kataloge bestimmen zusammen, welche Buchungen erstellt werden können (wo, wann und in welcher Währung).

Cachen Sie den Kontext

Diese Daten ändern sich selten. Holen Sie sie einmal beim Start und verwenden Sie sie wieder; aktualisieren Sie sie von Zeit zu Zeit, anstatt sie bei jeder Operation erneut anzufordern. Alle Endpunkte verwenden den Header Authorization: Bearer {token}.

Sprachen

GET /api/languages liefert die vom System unterstützten Sprachen. Sie bestimmen die gültigen Werte des Query-Parameters ?language=, der die Sprache der Antworten steuert (siehe Sprachen).

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

Hinweis

Für umfangreichere Metadaten zu jeder Sprache (nativer Name usw.) gibt es GET /api/languages-info.

Währungen

GET /api/currencies liefert die unterstützten Währungen mit ihrem Wechselkurs. Daraus ergibt sich der CurrencyCode, den Sie in GET /api/search, GET /api/booking/price und POST /api/booking/book verwenden.

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

[
  { "Id": 1, "ISOCode": "USD", "Name": "Dólar", "Symbol": "U$S", "ExchangeRate": 1.0, "IsSystemDefault": true },
  { "Id": 2, "ISOCode": "ARS", "Name": "Peso argentino", "Symbol": "$", "ExchangeRate": 950.0, "IsSystemDefault": false }
]

Feld	Beschreibung
ISOCode	ISO-Code der Währung. Er wird als CurrencyCode gesendet.
Symbol / Name	Zur Anzeige.
ExchangeRate	Wechselkurs gegenüber der Standardwährung des Systems.
IsSystemDefault	Kennzeichnet die Basiswährung des Mandanten.

Orte

GET /api/places liefert die Orte für Übergabe und Rückgabe. Ihre Id sind diejenigen, die als FromPlace/ToPlace (Suche) und DeliveryPlace/ReturnPlace (Buchung) übergeben werden. Jeder Ort gehört zu einer Filiale (BranchOfficeId) und hat einen Typ (Flughafen, Agentur, Hotel …), dessen Katalog GET /api/placetypes ist.

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

[
  {
    "Id": 1,
    "Name": "Aeropuerto LAX",
    "Category": "Aeropuerto",
    "City": "Los Angeles",
    "Country": "United States",
    "BranchOfficeId": 10,
    "BranchOfficeName": "LAX",
    "BranchOfficeIATACode": "LAX"
  }
]

Feld	Beschreibung
Id	Kennung des Ortes. Es ist der FromPlace/ToPlace/DeliveryPlace.Id.
Category	Art des Ortes (aus GET /api/placetypes).
BranchOfficeId / BranchOfficeName / BranchOfficeIATACode	Filiale, zu der er gehört.

Öffnungszeiten

GET /api/attentionschedule liefert die Konfiguration der Öffnungszeiten pro Filiale. Dies legt fest, wann ein Fahrzeug übergeben und zurückgegeben werden kann: Öffnungstage und -uhrzeiten, Zeitzone, Spannen (gaps) und Regeln außerhalb der Öffnungszeiten. Sie bestimmt, ob ein bestimmtes From/To für einen Ort gültig ist.

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

Feld	Beschreibung
Schedule	Öffnungszeiten-Spannen pro Tag.
TimezoneId / TimezoneUTCOffset	Zeitzone der Filiale (interpretieren Sie From/To in ihr).
Gap / GapForBookingTime	Mindestspannen zum Buchen / zwischen Operationen.
AllowAfterHours / BeforeHoursMaxMinutes / AfterHoursMaxMinutes	Ob ein Betrieb außerhalb der Öffnungszeiten erlaubt ist und mit welchen Grenzen.

Wie sie zusammenhängen

Um zu wissen, welche Buchungen erstellt werden können, kombinieren Sie die vier Kataloge:

Sprache (?language=)       → in welcher Sprache die Antworten kommen
        │
Ort (place)                → WO übergeben/zurückgegeben wird  (FromPlace / DeliveryPlace)
        │  gehört zu
        ▼
Filiale (branch office)
        │  hat
        ▼
Öffnungszeit               → WANN es gültig ist (Tage/Uhrzeiten/Zeitzone/after-hours) → definiert From/To
        │
Währung (CurrencyCode)     → IN WELCHER WÄHRUNG der Preis berechnet wird

In der Praxis:

1. Wählen Sie einen Ort für die Übergabe (und die Rückgabe) aus GET /api/places.
2. Sehen Sie sich die Öffnungszeiten seiner Filiale an (GET /api/attentionschedule), um ein From/To innerhalb der gültigen Spannen und in der richtigen Zeitzone festzulegen.
3. Wählen Sie eine unterstützte Währung (GET /api/currencies).
4. Optional legen Sie die Sprache der Antworten mit ?language= fest.

Damit können Sie bereits mit der Buchung von Anfang bis Ende beginnen.