Handbuch i-Reserve - API - Booking

Home Funktionale Informationen Verfügbare APIs API-Booking

Documentatie

difficulty level:

POST booking/add

Verwendet für

Erstellen einer Reservierung. Dieselben Prüfungen wie in der check-Funktion.
Wenn alle Prüfungen erfolgreich sind, wird die Reservierung erstellt.

Authentifizierung

Anonymer Zugriff

Parameter

Parameter	Beschreibung	Erforderlich	Beispiel
object_id	Objekt-ID der Reservierung	Ja*	1
combi_id	Objekt-ID der Reservierung	Ja*	2
fromdate	Von-Datum der Reservierung	Ja	2012-08-26
number	Anzahl der Plätze	Nein	1
tilldate	Bis-Datum der Reservierung. Wenn nicht gesetzt, gleich fromdate	Nein	2012-08-26
fromtime	Von-Zeit der Reservierung	Nein	10:00
tilltime	Bis-Zeit der Reservierung	Nein	12:00
customer	Kundenobjekt kann angegeben werden Wenn customer_id angegeben ist, wird die Reservierung mit diesem Kunden verknüpft	Nein
options	Eine Liste von Optionen, jeweils mit einer Kombination aus option_name und der gewünschten Anzahl	Nein
participants	Eine Liste von Teilnehmern, jeweils mit einer Kombination aus participant_name und der gewünschten Anzahl	Nein
voucher	Eine Liste von Geschenkgutscheinen. Nur gültige Geschenkgutscheine werden verwendet. Zu ungültigen Gutscheinen wird kein Feedback gegeben	Nein	VALIDVOUCHER1,VALIDVOUCHER2,INVALIDVOUCHER
channel	Kanal, für Berichtszwecke. Standard 'api'	Nein	api
subchannel	Unterkanal für Berichtszwecke	Nein

* Object_id ODER combi_id ist erforderlich. Eines von beiden muss angegeben werden

Beispiel 1

Erstellen Sie eine Reservierung für 4 Personen in einem bereits gebuchten Slot.

POST api/rest/booking/add

Request: 
{
  "object_id": "1",
  "fromdate": "2012-08-26",
  "tilldate": "2012-08-26",
  "fromtime": "10:15",
  "tilltime": "10:20",
  "number": "4",
  "voucher": "VALIDGIFTCARD"
}
Response: 
{
  "status": false,
  "messages": [
    "The selected period is not available"
  ]
}

Beispiel 2

Erstellen Sie eine Reservierung für 4 Personen (2 Erwachsene und 2 Kinder).
Geben Sie auch ein Kundenobjekt an und geben Sie eine Option an.

POST api/rest/booking/add

Request: 
{
  "object_id": "1",
  "fromdate": "2012-08-27",
  "tilldate": "2012-08-27",
  "fromtime": "10:15",
  "tilltime": "10:20",
  "number": "4",
  "customer": {
    "lastname": "Demo"
  },
  "participants": {
    "0": {
      "Volwassenen": "2"
    },
    "1": {
      "Kinderen": "2"
    }
  },
  "options": {
    "0": {
      "taart": "1"
    }
  }
}
Response: 
{
  "status": true,
  "booking_id": 40690,
  "messages": [
    "Booking made"
  ]
}

Beispiel 3 - Überlaufbuchung

Erstellen einer Reservierung für 8 Personen (5 Erwachsene und 3 Kinder).
"Überlauf von Perioden" bzw. die "Nutzung mehrerer Perioden bei Bedarf" findet Anwendung.

POST api/rest/booking/add

Request: 
{
  "object_id": "1",
  "fromdate": "2012-08-27",
  "tilldate": "2012-08-27",
  "fromtime": "10:15",
  "tilltime": "10:25",
  "customer": {
    "lastname": "Demo"
  },
  "participants": {
    "0": {
      "Volwassenen": "5"
    },
    "1": {
      "Kinderen": "3"
    }
  }
}
Response: 
{
  "status": true,
  "booking_id": 40693,
  "messages": [
    "Booking made"
  ]
}