OData-Queries erstellen

Dieser Leitfaden zeigt, wie Sie Abfragen gegen die OData-Endpunkte von Rently mit den Standardoptionen erstellen: filtern, Felder auswählen, Beziehungen expandieren, sortieren, paginieren und zählen. Alle Beispiele laufen über GET https://{tenant}.rently.com.ar/odata/... mit dem Header Authorization: Bearer {token}.

Aktivierte Optionen

Bei Rently sind $filter, $select, $expand, $orderby, $top, $skip und $count aktiviert. Collections werden serverseitig paginiert mit maximal 100 Datensätzen pro Seite.

Basis-Anfrage

curl 'https://{tenant}.rently.com.ar/odata/Bookings' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Die Antwort kommt im OData-Standardumschlag: Die Datensätze stehen in value.

{
  "@odata.context": "https://{tenant}.rently.com.ar/odata/$metadata#Bookings",
  "value": [
    { "Id": 1, "Code": "RNT-0001", "Currency": "USD", "IsQuotation": false }
  ]
}

$filter — filtern

Filtert die Collection nach Bedingungen über die Felder der Entität.

# Bestätigte Buchungen (keine Angebote) in USD
curl 'https://{tenant}.rently.com.ar/odata/Bookings?$filter=IsQuotation eq false and Currency eq '\''USD'\''' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Häufigste Operatoren:

Operator	Bedeutung	Beispiel
eq / ne	gleich / ungleich	Currency eq 'USD'
gt ge lt le	größer / größer-gleich / kleiner / kleiner-gleich	FromDate ge 2026-01-01T00:00:00Z
and or not	logische Verknüpfung	IsQuotation eq false and Balance gt 0
contains(...)	Teilzeichenkette	contains(Code,'RNT')
startswith(...)	beginnt mit	startswith(Lastname,'Do')

Werttypen

Strings stehen in einfachen Anführungszeichen ('USD'), Datumsangaben im Format ISO 8601 (2026-01-01T00:00:00Z) und Zahlen/Booleans ohne Anführungszeichen (Balance gt 0, IsQuotation eq false).

$select — Felder auswählen

Ruft nur die Felder ab, die Sie benötigen (schlankere Antworten).

curl 'https://{tenant}.rently.com.ar/odata/Bookings?$select=Id,Code,FromDate,ToDate,Currency' \
  -H 'Authorization: Bearer YOUR_TOKEN'

$expand — Beziehungen expandieren

Bezieht verwandte Entitäten in dieselbe Antwort ein. In Bookings können Sie unter anderem Customer, Category, DeliveryPlace, ReturnPlace und Agency expandieren.

# Buchungen mit eingebetteten Kunden- und Kategoriedaten
curl 'https://{tenant}.rently.com.ar/odata/Bookings?$expand=Customer,Category' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Sie können $expand mit $select innerhalb der Beziehung kombinieren:

curl 'https://{tenant}.rently.com.ar/odata/Bookings?$expand=Customer($select=Firstname,Lastname,EmailAddress)' \
  -H 'Authorization: Bearer YOUR_TOKEN'

$orderby — sortieren

# Neueste zuerst
curl 'https://{tenant}.rently.com.ar/odata/Bookings?$orderby=FromDate desc' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Akzeptiert asc (Default) oder desc sowie mehrere durch Komma getrennte Felder.

$top und $skip — paginieren

# Zweite Seite mit 20 Datensätzen
curl 'https://{tenant}.rently.com.ar/odata/Bookings?$top=20&$skip=20' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Maximum pro Seite

Der Server begrenzt jede Seite auf 100 Datensätze. Um große Mengen zu durchlaufen, iterieren Sie mit $skip in Schritten von $top.

$count — Gesamtzahl der Datensätze

Fügen Sie $count=true hinzu, um die Gesamtzahl in @odata.count zu erhalten, nützlich zum Paginieren in einer UI.

curl 'https://{tenant}.rently.com.ar/odata/Bookings?$count=true&$top=20' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "@odata.context": "https://{tenant}.rently.com.ar/odata/$metadata#Bookings",
  "@odata.count": 1532,
  "value": [ /* ...20 Buchungen... */ ]
}

Alles zusammen

Ein Beispiel, das mehrere Optionen kombiniert: bestätigte Buchungen ab einem Datum, mit expandiertem Kunden, nur einigen Feldern, sortiert und paginiert.

curl 'https://{tenant}.rently.com.ar/odata/Bookings?$filter=IsQuotation eq false and FromDate ge 2026-01-01T00:00:00Z&$expand=Customer($select=Firstname,Lastname)&$select=Id,Code,FromDate,Currency&$orderby=FromDate desc&$top=20&$count=true' \
  -H 'Authorization: Bearer YOUR_TOKEN'

URL kodieren

Wenn Sie diese URLs aus Code verwenden, denken Sie daran, die Werte zu URL-kodieren (Leerzeichen werden zu %20 usw.). Bei curl genügt es, die URL wie in den Beispielen in Anführungszeichen zu setzen.

Ressourcenspezifische Filter

Zusätzlich zu den OData-Optionen akzeptieren einige Endpunkte eigene Parameter:

• GET /odata/Bookings?customerId={id} — Buchungen eines Kunden (akzeptiert die interne Id oder die GlobalId des Kunden).
• GET /odata/Agencies?q={texto} — Schnellsuche nach Agenturen über Name oder IATA-Code.

Die Details jeder Ressource mit ihren Feldern und Parametern finden Sie im Abschnitt OData der Reference.