Introducción
La API Pública de Bui es una interfaz HTTP RESTful diseñada para ser consumida por las tiendas de cada tenant. Permite consultar el catálogo de productos y categorías, crear órdenes de compra y procesar pagos mediante distintas pasarelas.
URL base
Todas las rutas de la API utilizan el prefijo /api/v1:
http://api.public.bui.cl/api/v1En producción, reemplaza el host por el dominio asignado a tu servicio.
Formato
- Las peticiones y respuestas utilizan JSON (
Content-Type: application/json). - Las fechas se retornan en formato ISO 8601 (UTC).
- Los valores monetarios se retornan como strings decimales para evitar pérdida de precisión (ej.
"9990.00").
Versionado
La versión actual es v1. El número de versión forma parte de la URL base. Las versiones anteriores pueden mantenerse activas durante un período de deprecación anunciado.
Módulos disponibles
| Módulo | Descripción |
|---|---|
| Autenticación | Cómo autenticar cada petición con un token de tienda |
| Productos | Catálogo de productos y variantes |
| Categorías | Árbol de categorías del catálogo |
| Órdenes | Creación de órdenes de compra |
| Pagos | Pasarelas de pago (Transbank, MercadoPago) |
| Archivos | Subida de archivos para opciones de tipo FILE |
Códigos de respuesta HTTP
| Código | Significado |
|---|---|
200 | OK — la petición fue exitosa |
201 | Created — recurso creado correctamente |
301 | Redirect — redirección permanente |
400 | Bad Request — la petición tiene errores de formato |
401 | Unauthorized — token ausente o inválido |
404 | Not Found — recurso no encontrado |
422 | Unprocessable Entity — error de lógica de negocio |
500 | Internal Server Error — error interno del servidor |