Mobis Outlet · Developer resources

API pública para agentes y desarrolladores

Consulta el catálogo vigente de Mobis Outlet mediante una interfaz estructurada, pública y exclusivamente de lectura. La API permite buscar productos, comparar precios y descuentos, revisar variantes, consultar stock y recuperar especificaciones sin ejecutar JavaScript.

Inicio rápido

No se necesita una cuenta ni una clave de API. Envía una solicitud GET a la versión estable v1. Los precios se expresan en soles peruanos e incluyen IGV; las respuestas indican la fecha de los datos y exponen límites de consulta mediante las cabeceras estándar RateLimit-*.

curl 'https://mobis-outlet.com/api/v1/catalog?category=sillas-de-oficina&in_stock_only=true&limit=5'

Endpoints estables

Buscar el catálogo

GET /api/v1/catalog admite texto, categoría, rango de precio, descuento mínimo, color, disponibilidad, orden y paginación.

Consultar un producto

GET /api/v1/products/{slug} devuelve la ficha estructurada de un producto con imágenes, variantes, stock, entrega, envío y especificaciones.

Errores y recuperación

Los errores se devuelven como JSON con un código estable, un mensaje legible y, cuando corresponde, detalles para corregir la solicitud. Un exceso de consultas responde con HTTP 429 y Retry-After. Una ruta inexistente dentro de v1 responde con application/problem+json y enlaza nuevamente a esta documentación.

Versiones y deprecación

La versión mayor forma parte de la URL. Los cambios compatibles se incorporan en v1; un cambio incompatible se publica bajo una nueva versión. Si una versión debe retirarse, Mobis Outlet lo anunciará mediante las cabeceras Deprecation y Sunset con un mínimo de 90 días de anticipación.

Leer la política completa de versiones y deprecación

Alcance y límites de seguridad

La API no crea pedidos, no reserva inventario, no procesa pagos y no recibe datos personales. Un agente debe volver a consultar la variante antes de recomendar una compra y debe trasladar al usuario a la ficha canónica para cualquier acción comercial.