🛠️ Developer docs

API REST de Tastely

Integra tu sistema, app o POS con la plataforma Tastely. API REST con autenticación OAuth 2.0, SDKs y webhooks.

Quickstart

Obtén tu API key en el panel (Configuración → API) y haz tu primera petición:

# Listar platillos de tu menú
curl -X GET https://api.tastely.com/v1/items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

💡 Base URL: Todos los endpoints usan https://api.tastely.com/v1/

Autenticación

Tastely usa Bearer tokens. Incluye tu API key en el header Authorization de cada petición.

Authorization: Bearer ts_live_xxxxxxxxxxxxxxxxxxxx

Las claves de producción empiezan con ts_live_ y las de prueba con ts_test_. Nunca expongas tu clave en código del lado del cliente.

Rate limits

Los límites varían por plan:

Free: 100 peticiones/hora
Pro: 1,000 peticiones/hora
Enterprise: Sin límite (fair use)

⚠️ Si excedes el límite recibirás un error 429 Too Many Requests. El header X-RateLimit-Reset indica cuándo se renueva el límite.

Platillos — /items

GET /items

Lista todos los platillos de tu menú.

// GET /v1/items?page=1&limit=20&category_id=3

{
  "data": [
    {
      "id": 412,
      "name": "Tacos al pastor",
      "price": 89.00,
      "available": true,
      "category_id": 3
    }
  ],
  "meta": { "total": 48, "page": 1 }
}

POST /items

Crea un platillo nuevo.

// Body (application/json)
{
  "name":        "Tacos al pastor",
  "price":       89.00,
  "category_id": 3,
  "description": "Carne de cerdo marinada con piña",
  "available":   true,
  "tags":        ["picante", "popular"]
}

Webhooks

Recibe notificaciones en tu servidor cuando ocurran eventos. Configura tu endpoint en Configuración → Webhooks.

order.created — Nuevo pedido recibido
item.updated — Platillo modificado
menu.published — Menú publicado

SDKs oficiales

# Node.js
npm install @tastely/sdk

# PHP
composer require tastely/sdk

# Python
pip install tastely

🔗 Repositorios: Todos los SDKs son open-source en github.com/tastely