Referencia de la APIProductos
Listar
Consulta el listado paginado de los productos de tu organización.
Descripción general
Este endpoint devuelve un listado paginado de los productos de tu organización, del más reciente al más antiguo. Cada producto incluye su categoría y sus impuestos. El tamaño de página es fijo en 20 resultados.
Requiere el permiso Leer en Productos.
Endpoint
GET
https://app.credonix.mx/api/v1/productsConsulta productos
Sin query params devuelve todos los productos. Usa search para buscar por texto y category_id para consultar los productos de una categoría. Puedes combinar ambos filtros. Cada producto tiene la misma forma que en Consultar producto.
Query params
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
search | string | No | - | Busca el texto en name, description o code, sin distinguir mayúsculas y minúsculas. |
category_id | string | No | - | Devuelve solo los productos de esa categoría. Si ninguna categoría tiene ese id, results llega vacío. |
Errores
| Status | Código | Causa |
|---|---|---|
400 | INVALID_PAGE | page no es un número entero entre 1 y 107374183. |
401 | MISSING_API_KEY, INVALID_API_KEY, API_KEY_REVOKED | API key ausente, inválida o revocada. |
403 | INSUFFICIENT_PERMISSIONS | La API key no tiene el permiso Leer en Productos. |