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