API Reference

Base URL: https://app.omnibuy.net/api/v1

La API OmniBuy es REST con JSON. Todos los endpoints requieren autenticación Bearer y un tenant context.

Convenciones

• Precios: centavos enteros (int64). 5500 = S/ 55.00
• Fechas: ISO 8601 UTC (2026-04-08T12:00:00Z)
• IDs: UUID v4
• Paginación: cursor-based (?cursor=xxx&limit=25)
• Ordenamiento: ?sort=-created_at,title (prefijo - = descendente)
• Filtros: ?filter[status]=active&filter[vendor]=Acme

Respuestas

Éxito:

{ "data": { ... } }

Lista:

{
  "data": [ ... ],
  "meta": { "pagination": { "cursor": "xxx", "has_next": true, "limit": 25 } }
}

Error:

{ "error": { "code": "RESOURCE_NOT_FOUND", "message": "..." } }

OpenAPI Spec

Descarga la especificación completa: api/openapi/openapi.yaml