API REST
La API deja que otros sistemas (tu tienda, Zapier o Make, tus scripts) lean y cambien registros de tus colecciones. Usa JSON en https://<tu app>/api/v1. Cada llave es una cuenta de servicio con su rol, sus colecciones y acciones, y un vencimiento opcional.
Cómo se usa
Sección titulada «Cómo se usa»- Ve a «Configuración → API» y crea una llave: nombre, rol (uno de la empresa o uno propio), colecciones y acciones, y vencimiento (30, 90, 180 o 365 días, o sin vencimiento).
- Copia el token
hska_…: se muestra una sola vez. - Llama con
Authorization: Bearer hska_…:GET /collectionsGET /collections/{clave}/records(cursor, filtros, orden yupdatedSince)GET /collections/{clave}/records/{id}POST /collections/{clave}/records(uno o un lote de hasta 50)PATCH /collections/{clave}/records/{id}(conIf-Matchopcional)DELETE /collections/{clave}/records/{id}(a la papelera)
- Rota la llave (el token anterior puede seguir 1 o 24 horas) o revócala.
Reglas y límites
Sección titulada «Reglas y límites»- Solo para servidores: un pedido desde un navegador recibe
403 cors_not_allowed. - 120 llamadas por minuto por llave y 600 por empresa; cuerpo de 256 KB; páginas de hasta 100; 10 filtros por pedido; 100 llaves vigentes.
- Lo que escribe una llave queda a su nombre y pasa por las mismas reglas y automatizaciones que la app.
- Administrar llaves pide
api:manage. La empresa puede apagar la API (403 api_disabled).
Para agentes (MCP)
Sección titulada «Para agentes (MCP)»- No hay herramientas MCP para crear llaves: se crean en la app.
- Para trabajar con registros desde un agente usa el MCP (
list_records,create_records,search_records) en lugar de la API.