1. Home
  2. Dokumente
  3. bookyt API Grundlagen
  4. Buchungsdaten auslesen

Buchungsdaten auslesen

Text:

Der API-Aufruf „get_bookings“ ermöglicht es, ein Array von Buchungen und den zugehörigen Daten als JSON zurückzugeben. Dieser Aufruf bietet eine leistungsstarke Möglichkeit, um detaillierte Informationen über Buchungen in der Bookyt Vermietsoftware abzurufen. Hier sind die verschiedenen Filtermöglichkeiten und Beispiele, wie du sie verwenden kannst:

  • call=get_bookings: Dieser Teil des Aufrufs gibt an, dass du Buchungsdaten abrufen möchtest.
  • date (optional): Du kannst den optionalen Parameter „date“ verwenden, um Buchungen nach einem bestimmten Datum zu filtern. Wenn du beispielsweise alle Buchungen für den 4. August 2023 abrufen möchtest, setzt du „date=2023-08-04“ in deinen API-Aufruf.
  • date_stop (optional): Wenn du einen Zeitraum eingrenzen möchtest, kannst du den Parameter „date_stop“ nutzen. Dies ermöglicht es dir, Buchungen bis zu einem Enddatum zu filtern.
  • station_id (optional): Mit „station_id“ kannst du Buchungen nach der Stations-ID filtern. So erhältst du Buchungen, die speziell mit einer bestimmten Station in Verbindung stehen.
  • buchung_id (optional): Wenn du nach einer bestimmten Buchungs-ID suchst, kannst du den Parameter „buchung_id“ verwenden, um gezielt nach dieser Buchung zu filtern.
  • category_id (optional): Die Filterung nach Kategorie-ID („category_id“) erlaubt es dir, Buchungen für bestimmte Kategorien von Ressourcen oder Dienstleistungen zu isolieren.

Hier ist ein Beispiel für einen vollständigen API-Aufruf, der die verschiedenen Filteroptionen verwendet:

curl -X GET 'https://deine-frontend-url/api.php?call=get_bookings&date=2023-08-04&station_id=123&category_id=456&token=xyz'

Die JSON-Ausgabe enthält dann eine Liste von Buchungen, die den angegebenen Filterkriterien entsprechen. Jede Buchung wird durch ein JSON-Objekt repräsentiert und enthält wichtige Informationen wie die Buchungs-ID, das Datum, die Stations-ID, die Kategorie-ID, den Betrag und den Namen des Kunden. Dieser API-Aufruf ist äußerst nützlich, um maßgeschneiderte Einblicke in deine Buchungsdaten zu erhalten und sie entsprechend deiner Anforderungen zu analysieren.