API - Dokumentation für Entwickler
jajabu API > v2 > buchungsanfragen-anzeigen

buchungsanfragen-anzeigen

Zeigt alle Buchungsanfragen ab Zeitpunkt seit an.

URL / Methode

Ziel-URL https://api.jajabu.com/v2/buchungsanfragen-anzeigen
Methode HTTP POST
Datenformat JSON im POST-Nachrichten-Body
Verarbeitungasynchron

Eingabe-Parameter

Name Typ Pflichtfeld / Standard Beschreibung
pid Zeichenkette Pflichtfeld Produkt-ID
uid Ganzzahl Pflichtfeld Kundennummer des Vermieters
pass Zeichenkette Pflichtfeld API-Kennwort des Vermieters für den Zugriff
seit YYYY-MM-DDThh:mm:ss Pflichtfeld Datum/Uhrzeit ab wann die Buchungen angezeigt werden sollen.

Rückgabe

Name Typ Beschreibung
letzteanfrage YYYY-MM-DDThh:mm:ss Datum/Uhrzeit der letzten Buchungsanfrage.

Die Information ist redundant und dient nur der einfachen Umsetzung: Der Wert soll für die nächste Abfrage im Parameter seit verwendet werden. Falls buchungsanfragen nicht leer ist, entspricht letzteanfrage dem Zeitstempel der letzten Buchungsanfrage; anderenfalls entspricht letzteanfrage dem Eingabe-Parameter seit.

Eine regelmässige Abfrage der Buchungsanfragen könnte damit wie folgt aussehen (Pseudo-Code):
$seit = '2000-01-01T00:00:00';
while (true) {
  $daten = buchungsanfragen-anzeigen(seit = $seit);
  $seit = $daten['letzteanfrage'];
  // verarbeite $daten['buchungsanfragen'] ...
  sleep 1 min
}
                
buchungsanfragen Feld
Name Typ Beschreibung
oid Ganzzahl Objekt-ID
zeitpunkt YYYY-MM-DDThh:mm:ss Datum/Uhrzeit der Buchungsanfrage
anrede Aufzählung: 'herr' / 'frau' Anrede
nachname Zeichenkette(255) Nachname
vorname Zeichenkette(255) Vorname
email Zeichenkette(255) E-Mail-Adresse
von YYYY-MM-DD Frühestmöglicher Anreisetermin
bis YYYY-MM-DD Spätestmöglicher Abreisetermin
mintage Ganzzahl Gewünschte Mindestanzahl Übernachtungen
maxtage Ganzzahl Gewünschte Maximalanzahl Übernachtungen
erwachsene Ganzzahl Anzahl Erwachsene
kinder Ganzzahl Anzahl Kinder
telefon Zeichenkette(255) Telefonnummer
strasse Zeichenkette(255) Straße
hausnummer Zeichenkette(255) Hausnummer
plz Zeichenkette(255) Postleitzahl
ort Zeichenkette(255) Ort
land Zeichenkette(2) Landeskennzahl (ISO 3166)
nachricht Zeichenkette(1000) Freitext des Mietinteressenten