Saltar al contenido
tablezio
Crear mi carta gratis

API de Tablezio

Crea con la misma API que mueve Tablezio.

Una API REST para operaciones de restaurante. Gestiona pedidos, menús, reservas, inventario, clientes, fidelización y analíticas. Recibe webhooks firmados en tiempo real ante cada cambio del ciclo de vida.

Cómo funciona

Toda cuenta de Tablezio incluye acceso a la API. Creas una clave en el panel, firmas las peticiones con el header X-API-Key y ya hablas con el mismo backend que mueve nuestras apps web y móvil.

La API es REST sobre HTTPS. Los recursos devuelven JSON con claves en snake_case, IDs prefijados (ord_, mi_, rsv_, …) y timestamps Unix. Los endpoints de lista usan paginación por cursor. Las mutaciones soportan claves de idempotencia. Los webhooks se firman con HMAC-SHA256.

Un tour de 30 segundos

Autentícate y lista los pedidos más recientes:

curl
curl https://api.tablezio.com/v1/orders \
  -H 'X-API-Key: tbz_…' \
  -G --data-urlencode 'limit=3'

Recibirás un envelope de lista estilo Stripe:

200 OK · application/json
{
  "object": "list",
  "data": [
    { "id": "ord_507f1f77bcf86cd799439011", "object": "order", "type": "dine_in", "status": "completed", "total": 4290, "currency": "usd", "created": 1716657600 },
    { "id": "ord_5a1b2c3d4e5f6a7b8c9d0e1f", "object": "order", "type": "takeout",  "status": "preparing", "total": 1850, "currency": "usd", "created": 1716657480 },
    { "id": "ord_6b2c3d4e5f6a7b8c9d0e1f20", "object": "order", "type": "delivery", "status": "placed",    "total": 3120, "currency": "usd", "created": 1716657300 }
  ],
  "has_more": true,
  "next_cursor": "v1:6b2c3d4e5f6a7b8c9d0e1f20:1716657300000",
  "previous_cursor": null,
  "url": "/v1/orders"
}

Principios de diseño

  • Predecible. Cada recurso tiene el mismo envelope: id, object, created, updated, más sus propios campos.
  • Versionada. Nunca rompemos /v1. Los cambios aditivos son seguros; los rupturistas pasan a una nueva versión mayor.
  • Modismos compatibles con Stripe. Paginación por cursor, expansiones, claves de idempotencia, webhooks firmados — los mismos patrones que tu equipo ya conoce.
  • Sandbox incluido. Marca una clave como sandbox para correr tests de extremo a extremo sin tocar datos de producción.

¿Por dónde sigo?