API

Mithilfe der BOOK2EAT-API kann das aktuelle Menü abgefragt werden. Hierfür erstellen Sie sich mithilfe Ihrer E-Mail einen token mithilfe dessen Sie dann unbegrenzt Abfragen senden können.

Service URL

my.book2eat.eu/c/api/

Abfragen aller Restaurants

Zuerst können Sie alle Restaurants abfragen, die zur Zeit mithilfe von BOOK2EAT ihren Bestellprozess vereinfachen. Hierfür ist kein token notwendig. Sie müssen lediglich eine POST Request an die Service URL mit dem Variablennamen get_canteen senden

get_canteen: [NULL]

Content-Type: application/json

curl -d 
   "get_canteen=true" 
   -X POST https://my.book2eat.eu/c/api/
{
   "error":false,
   "message":"OK",
   "data":{
      "canteen":{
         "987654321":{
            "canteen_ID":"987654321",
            "name":"DEMO",
            "short_name":"DEMO",
            "logo":"https: book2eat.eu/demo.png",
            "city":"Stadt",
            "zip":"1234",
            "street":"Musterstra\u00dfe",
            "street_number":"12",
            "allowed":"Jeder! Einfach Registrieren und Testen!",
            "description":"Einfach ausprobieren!",
            "mail":"info@book2eat.eu",
            "website":"https:book2eat.eu"
         }
      }
   }
}

Erstellen eines API-Accounts

Mithilfe der canteen_ID, die im obigen Schritt abgefragt wurde können Sie nun mithilfe von dieser und Ihrer E-Mail einen token beantragen. Diesen erhalten Sie kurze Zeit darauf per E-Mail. Des Weiteren erhalten Sie einen restore_token. Mithilfe von diesem können Sie einen neuen token generieren.

canteen_ID: [int] Identifizerung des Restaurants, kann mithilfe von get_canteen abgefragt werden

new_account: [string] Ihre E-Mail Adresse

Content-Type: application/json

curl -d 
   "canteen_ID=987654321&new_account=max@musterman.com" 
   -X POST https://my.book2eat.eu/c/api/
{
   "error":false,
   "message":"An die angegebene E-Mail wurde ein Token gesendet!"
}

Erneuern des Tokens

Um Ihren token zu erneuern ist eine Abfrage mit der canteen_ID und ihrem restore_token zu stellen.

canteen_ID: [int] Identifizerung des Restaurants, kann mithilfe von get_canteen abgefragt werden.

new_token: [string] Hier bitte den restore_token verwenden, den Sie per E-Mail erhalten haben.

Content-Type: application/json

curl -d 
   "canteen_ID=987654321&new_token=ea16bvo1dsko" 
   -X POST https://my.book2eat.eu/c/api/
{
   "error":false,
   "message":"Neuer Token erstellt",
   "data":{
      "token":"hyzmgty9hbrfuw3h83yatdaoc"
   }
}

Abfragen des Menüs

Um nun das aktuelle Menü abzufragen sind die Parameter canteen_ID, token und date notwendig. Sollte an dem gewünschten Tag kein Menü vorhanden sein, erhalten Sie „Heute keine Küche“ zurück.

canteen_ID: [int] Identifizerung des Restaurants, kann mithilfe von get_canteen abgefragt werden

token: [string] Hier bitte den Token aus der E-Mail verwenden; oder sollten Sie diesen via new_token erneuert haben, die Antwort von dieser Request verwenden.

date: [Y-m-d] Das Datum der Abfrage z.B.: 2022-11-16

Content-Type: application/json

curl -d 
   "canteen_ID=987654321&token=ea16bvo1dsko&date=2022-11-16" 
   -X POST https://my.book2eat.eu/c/api/
{
   "error":false,
   "message":"OK",
   "data":{
      "menue":{
         "22815":{
            "menues_ID":22815,
            "name":"DEMO",
            "typ_ID":1,
            "typ_name":"Vorspeise",
            "price":"5.00",
            "vegetarian":false,
            "allergenic":"A,B,C,D,E",
            "terminal":1,
            "date":"2022-11-23",
            "consume_from":"11:00:00",
            "consume_to":"19:00:00",
            "canteen_ID":"987654321"
         }
      }
   }
}