Ir al contenido

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.

  1. 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).
  2. Copia el token hska_…: se muestra una sola vez.
  3. Llama con Authorization: Bearer hska_…:
    • GET /collections
    • GET /collections/{clave}/records (cursor, filtros, orden y updatedSince)
    • GET /collections/{clave}/records/{id}
    • POST /collections/{clave}/records (uno o un lote de hasta 50)
    • PATCH /collections/{clave}/records/{id} (con If-Match opcional)
    • DELETE /collections/{clave}/records/{id} (a la papelera)
  4. Rota la llave (el token anterior puede seguir 1 o 24 horas) o revócala.
  • 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).
  • 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.