Einführung
In diesem Teil erhalten Sie Informationen, wie auf sämtliche Buchungen zugegriffen werden kann.
Allgemeine Information
Diese Ressource unterstützt die folgenden Operationen:
Name | URL | GET | POST | PUT | DELETE | Status |
---|---|---|---|---|---|---|
Buchungen | v1/bookings | Ja | Ja | Ja | – |
Wenn Sie auf diese Ressource zugreifen möchten, verwenden Sie folgende URL:
Definitionen
GET Parameter für Abfrage
Sämtliche Parameter, welche bei einer GET Anfrage enthalten sein können oder erforderlich sind:
Parameter | Art | Beschreibung | Erforderlich |
---|---|---|---|
language | String | Sprache z.B. „de“ oder en, fr, es, cn, cs | Ja |
limit > start | Integer | Ab welcher Position ausgeben, Paging | – |
limit > reply | Integer | Anzahl Antworten, max 10 | – |
filter > id | Array | Nur eine bestimmte Buchung ausgeben
| (Ja) |
filter > offer.id | Array | Nur Buchungen von einem bestimmten Angebot
| (Ja) |
filter > user.id | Array | Nur Buchungen von einem bestimmten User
| (Ja) |
filter > status | Array | Abgeschlossene Buchungen, oder Warteliste
| – |
order > time | Array | Sortieren nach Buchungszeit
| – |
(Ja) Ist erforderlich
Es muss zwingend eine Buchungs ID, Angebots ID oder eine User ID übergeben werden
Rückgabewerte
Feld | Art | Beschreibung | Objekt |
---|---|---|---|
id | String | edoobox ID | |
status | String | „default“ „waitinglist“ „mustpay“ | |
time | String | Buchungsdatum im Format ISO_8601 | |
offer_id | Float | Angebot ID | |
owner | Array | Enthält die User ID des Besitzers und die Konto Buchung mit Nummer | |
users | Array | Enthält die Teilnehmer in dieser Buchung und die Preiskategorie ID |
GET Rückgabewerte erweitern
Werden diese Parameter bei einer GET Anfrage übergeben, werden zusätzliche Werte zurückgegeben.
Feld | Art | Beschreibung | Objekt |
---|---|---|---|
users | Array | Teilnehmer in der Buchung, Sammelteilnehmer
| Teilnehmer |
GET Beispiel
Dazu ein Beispiel, wie diese Parameter im GET-Request übergeben werden. Dieses Beispiel enthält alle Parameter, somit müssen erst die unnötigen Parameter entfernt werden:
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<?php | |
$ApiData = $client->get('bookings', array( | |
'language' => 'de', | |
'filter' => array( | |
array( | |
'property' => 'booking.id', | |
'value' => 'booking_abc_1234' | |
), | |
array( | |
'property' => 'offer.id', | |
'value' => 'offer_abc_1234' | |
), | |
array( | |
'property' => 'user.id', | |
'value' => 'user_abc_1234' | |
), | |
array( | |
'property' => 'booking.status', | |
'value' => 'default' | |
) | |
), | |
'order' => array( | |
array( 'property' => 'booking.time', | |
'value' => 'DESC' | |
) | |
), | |
'data' => array( | |
array( | |
'property' => 'booking.users', | |
'value' => array( | |
'filter' => array(), | |
'limit' => array(), | |
'order' => array() | |
) | |
) | |
) | |
)); |