ConsoleAller au site

API FlavosoRéférence de l'APITables et zones

Tables et zones

Les tables et les zones de l'établissement, par exemple pour attribuer une réservation à une table. En lecture seule, avec store:read ou reservations:read. La clé du QR code d'une table n'y figure jamais.

Points de terminaison

List tables

get/tables

Droit:
store:readoureservations:read
Offre:
toutes les offres

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.

Paramètres

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

Réponse200

OK

  • objectstringobligatoire

    Always list.

    Valeurs:"list"

  • dataTable[]obligatoire

    The items of this page.

    Champs contenus (7)
    • objectstringobligatoire

      Always table.

      Valeurs:"table"

    • idstring (uuid)obligatoire

      The table.

    • labelstringobligatoire

      Its name, e.g. 4 or Window.

    • seatsintegerobligatoire

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

    • area_idstring (uuid)obligatoirepeut être null

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

    • bookable_onlinebooleanobligatoire

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

    • min_partyintegerobligatoirepeut être null

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

  • has_morebooleanobligatoire

    Whether another page follows.

  • next_cursorstringobligatoirepeut être null

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

Erreurs

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

Tous les codes d'erreur

Requête
curl "https://api.flavoso.com/v1/tables" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Réponse
{
  "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

Droit:
store:readoureservations:read
Offre:
toutes les offres

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

Paramètres

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

Réponse200

OK

  • objectstringobligatoire

    Always list.

    Valeurs:"list"

  • dataArea[]obligatoire

    The items of this page.

    Champs contenus (4)
    • objectstringobligatoire

      Always area.

      Valeurs:"area"

    • idstring (uuid)obligatoire

      The area.

    • namestringobligatoire

      Its name, e.g. Terrace.

    • bookable_onlinebooleanobligatoire

      Its tables count for online bookings.

  • has_morebooleanobligatoire

    Whether another page follows.

  • next_cursorstringobligatoirepeut être null

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

Erreurs

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

Tous les codes d'erreur

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

Une question reste ouverte ? Écrivez à support@flavoso.com en indiquant l'identifiant de X-Request-Id. Il nous permet de retrouver votre requête dans le journal.