SDK Datos y API

Todas las operaciones de datos se hacen a través de endpoints personalizados que creas en el API Builder. HeroMate no genera endpoints REST automáticos para tus tablas — siempre necesitas crearlos primero.

Llamar a Endpoints (`dypai.api`)

Usa dypai.api para llamar a cualquier endpoint creado con el API Builder. Todos los métodos HTTP están soportados.

GET (Lectura)

Recupera datos con filtrado y paginación integrados.

JavaScript

// Lista simple
const { data, error } = await dypai.api.get('buscar_productos', {
  params: { categoria: 'electronica', limit: 10 }
});

// Lista paginada
const { data, error } = await dypai.api.get('buscar_productos', {
  params: { limit: 20, offset: 0 }
});

POST (Crear / Acción)

Crea registros o dispara flujos de trabajo complejos.

JavaScript

const { data, error } = await dypai.api.post('crear_pedido', {
  cliente_id: 'uuid-123',
  items: [{ id: 'p1', cantidad: 2 }]
});

PUT / PATCH (Actualizar)

JavaScript

const { data, error } = await dypai.api.put('actualizar_producto/product-uuid', {
  precio: 29.99
});

DELETE (Eliminar)

JavaScript

const { error } = await dypai.api.delete('eliminar_producto/product-uuid');

Cada nombre de endpoint (ej. buscar_productos, crear_pedido) debe corresponder a un endpoint que hayas creado en el API Builder. Si el endpoint no existe, el SDK devolverá un error 404.

¿Streaming de un endpoint de agente IA?

Para endpoints de agentes IA (y cualquier endpoint marcado como is_tool), usa dypai.api.stream(name, body) para recibir los tokens según se generan. El hook useChat lo envuelve por ti — consulta Chat IA.

Operadores de Filtrado

Al usar params en peticiones GET, puedes usar operadores potentes:

Operador	Descripción	Ejemplo
`eq`	Igual a	`status: { eq: 'activo' }`
`gt` / `gte`	Mayor que	`precio: { gte: 100 }`
`contains`	Búsqueda de texto	`nombre: { contains: 'pizza' }`
`in`	En lista	`id: { in: ['1', '2'] }`

Llamar a Endpoints (dypai.api)

Usa dypai.api para llamar a cualquier endpoint creado con el API Builder. Todos los métodos HTTP están soportados.

Recupera datos con filtrado y paginación integrados.

JavaScript

// Lista simple
const { data, error } = await dypai.api.get('buscar_productos', {
  params: { categoria: 'electronica', limit: 10 }
});

// Lista paginada
const { data, error } = await dypai.api.get('buscar_productos', {
  params: { limit: 20, offset: 0 }
});

Crea registros o dispara flujos de trabajo complejos.

JavaScript

const { data, error } = await dypai.api.post('crear_pedido', {
  cliente_id: 'uuid-123',
  items: [{ id: 'p1', cantidad: 2 }]
});

JavaScript

const { data, error } = await dypai.api.put('actualizar_producto/product-uuid', {
  precio: 29.99
});

JavaScript

const { error } = await dypai.api.delete('eliminar_producto/product-uuid');

Cada nombre de endpoint (ej. buscar_productos, crear_pedido) debe corresponder a un endpoint que hayas creado en el API Builder. Si el endpoint no existe, el SDK devolverá un error 404.

¿Streaming de un endpoint de agente IA?

Operador

Descripción

Ejemplo

eq

Igual a

status: { eq: 'activo' }

gt / gte

Mayor que

precio: { gte: 100 }

contains

Búsqueda de texto

nombre: { contains: 'pizza' }

in

En lista

id: { in: ['1', '2'] }