Microservicio de catálogo de imágenes

Productos Colombia

Servicio centralizado para almacenar, validar y consultar imágenes e información básica de productos identificados principalmente por código de barras.

Ver documentación API Abrir buscador Subir producto

Beneficios

Una imagen, muchos catálogos

Las empresas registran la imagen una vez y los comercios electrónicos la consumen.

Validación automática

Fondo blanco, moderación de contenido y optimización de peso antes de publicar.

Sincronización nocturna

API por fecha de actualización con paginación por cursor estable.

Flujo básico de uso

01

Registrar producto

POST /api/productos con código de barras, nombre, categoría y gramaje.

02

Subir imagen

POST /api/productos/{id}/imagen con validación técnica e IA.

03

Consultar catálogo

GET por código, lista de códigos, búsqueda o fecha de actualización.

Ejemplo de integración

{
  "codigosBarra": ["7701234567890", "7709876543210"]
}

POST /api/productos/buscar-por-codigos

Autenticación

  • Consultas: acceso público con rate limiting (120 req/min por IP).
  • Escritura: JWT Bearer o header X-Api-Key (formato prefijo.secreto).
  • Roles: Administrador, Empresa, Consultor, Moderador.