ConsoleVai al sito

API di FlavosoRiferimento APITavoli e aree

Tavoli e aree

I tavoli e le aree del locale, per esempio per assegnare una prenotazione a un tavolo. Solo lettura, con store:read o reservations:read. La chiave del codice QR di un tavolo non compare mai.

Endpoint

List tables

get/tables

Permesso:
store:readoreservations:read
Piano:
tutti i piani

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.

Parametri

NomePosizioneDescrizione
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.

Risposta200

OK

  • objectstringobbligatorio

    Always list.

    Valori:"list"

  • dataTable[]obbligatorio

    The items of this page.

    Campi interni (7)
    • objectstringobbligatorio

      Always table.

      Valori:"table"

    • idstring (uuid)obbligatorio

      The table.

    • labelstringobbligatorio

      Its name, e.g. 4 or Window.

    • seatsintegerobbligatorio

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

    • area_idstring (uuid)obbligatoriopuò essere null

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

    • bookable_onlinebooleanobbligatorio

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

    • min_partyintegerobbligatoriopuò essere null

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

  • has_morebooleanobbligatorio

    Whether another page follows.

  • next_cursorstringobbligatoriopuò essere null

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

Errori

  • 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.

Tutti i codici di errore

Richiesta
curl "https://api.flavoso.com/v1/tables" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Risposta
{
  "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

Permesso:
store:readoreservations:read
Piano:
tutti i piani

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

Parametri

NomePosizioneDescrizione
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.

Risposta200

OK

  • objectstringobbligatorio

    Always list.

    Valori:"list"

  • dataArea[]obbligatorio

    The items of this page.

    Campi interni (4)
    • objectstringobbligatorio

      Always area.

      Valori:"area"

    • idstring (uuid)obbligatorio

      The area.

    • namestringobbligatorio

      Its name, e.g. Terrace.

    • bookable_onlinebooleanobbligatorio

      Its tables count for online bookings.

  • has_morebooleanobbligatorio

    Whether another page follows.

  • next_cursorstringobbligatoriopuò essere null

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

Errori

  • 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.

Tutti i codici di errore

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

Qualcosa non è chiaro? Scrivi a support@flavoso.com indicando l'identificativo di X-Request-Id. Così troviamo la tua richiesta nel registro.