KonsoleZur Website

Flavoso APIAPI-ReferenzTische und Bereiche

Tische und Bereiche

Die Tische und Bereiche des Betriebs, etwa um Reservierungen einem Tisch zuzuordnen. Nur lesen, mit store:read oder reservations:read. Der Schlüssel im QR-Code eines Tisches steht nie darin.

Endpunkte

List tables

get/tables

Recht:
store:readoderreservations:read
Tarif:
jeder Tarif

The restaurant's tables with seats, area and booking rules, in the order they were created. Table orders (Order.table.id) and reservations (Reservation.table_ids) point to these ids. Needs store:read or reservations:read.

Parameter

NameOrtBeschreibung
limitintegerqueryPage size, 1 to 100. Default 25.1 to 100 · default 25
cursorstringquerynext_cursor of the previous page. Opaque; send the same filters again with it.

Antwort200

OK

  • objectstringPflicht

    Always list.

    Werte:"list"

  • dataTable[]Pflicht

    The items of this page.

    Felder darin (7)
    • objectstringPflicht

      Always table.

      Werte:"table"

    • idstring (uuid)Pflicht

      The table.

    • labelstringPflicht

      Its name, e.g. 4 or Window.

    • seatsintegerPflicht

      Seats; the restaurant's default table size when none is set.

    • area_idstring (uuid)Pflichtkann null sein

      The area (GET /areas); null when not placed in one.

    • bookable_onlinebooleanPflicht

      Guests may get it when booking online (staff and your app may always).

    • min_partyintegerPflichtkann null sein

      Only given to parties of at least this size; null for any.

  • has_morebooleanPflicht

    Whether another page follows.

  • next_cursorstringPflichtkann null sein

    Pass as cursor (with the same filters) to get the next page; null on the last page.

Fehler

  • 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
  • 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
  • 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
  • 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
  • 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Anfrage
curl "https://api.flavoso.com/v1/tables" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Antwort
{
  "object": "list",
  "data": [
    {
      "object": "table",
      "id": "3c7a9e1f-5b2d-4f8a-9c6e-7d1b3a5f9e24",
      "label": "4",
      "seats": 4,
      "area_id": "9e2d4b6f-1a3c-4e5d-8b7f-2c4e6a8d0f13",
      "bookable_online": true,
      "min_party": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}

List areas

get/areas

Recht:
store:readoderreservations:read
Tarif:
jeder Tarif

The areas of the floor plan (dining room, terrace), in the order they were created. Needs store:read or reservations:read.

Parameter

NameOrtBeschreibung
limitintegerqueryPage size, 1 to 100. Default 25.1 to 100 · default 25
cursorstringquerynext_cursor of the previous page. Opaque; send the same filters again with it.

Antwort200

OK

  • objectstringPflicht

    Always list.

    Werte:"list"

  • dataArea[]Pflicht

    The items of this page.

    Felder darin (4)
    • objectstringPflicht

      Always area.

      Werte:"area"

    • idstring (uuid)Pflicht

      The area.

    • namestringPflicht

      Its name, e.g. Terrace.

    • bookable_onlinebooleanPflicht

      Its tables count for online bookings.

  • has_morebooleanPflicht

    Whether another page follows.

  • next_cursorstringPflichtkann null sein

    Pass as cursor (with the same filters) to get the next page; null on the last page.

Fehler

  • 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
  • 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
  • 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
  • 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
  • 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Anfrage
curl "https://api.flavoso.com/v1/areas" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Antwort
{
  "object": "list",
  "data": [
    {
      "object": "area",
      "id": "9e2d4b6f-1a3c-4e5d-8b7f-2c4e6a8d0f13",
      "name": "Terrace",
      "bookable_online": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Etwas unklar geblieben? Schreib an support@flavoso.com und nenne die Kennung aus X-Request-Id. Damit finden wir deine Anfrage im Protokoll.