SDK Datos y API

Todas las operaciones de datos se hacen a través de endpoints personalizados que creas en el API Builder. DYPAI 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.

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.

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'] }