Iniciar sesión Solicitar demo
Recursos técnicos

API Docs

Integre catálogo y autenticación de Blume con una referencia clara, simple y lista para implementar.

Cómo empezar Ver endpoints
Base URL: https://xapi.madebyblume.com

Inicio rápido

Cómo empezar

La API utiliza autenticación OAuth con client_credentials. Incluya Authorization: Bearer <access_token> en las solicitudes autenticadas.

Pasos iniciales

  1. Solicite sus credenciales: client_id y client_secret.
  2. Obtenga un token vía POST /v1/i/token.
  3. Use el token como Bearer para consumir los endpoints disponibles.

Autenticación

POST /v1/i/token

Solicite un token firmado y úselo en el encabezado Authorization para las llamadas posteriores.

Base URL: https://xapi.madebyblume.com

Endpoint de token: POST /v1/i/token

Content-Type: application/x-www-form-urlencoded

Cuerpo (form-urlencoded)

Campo Tipo Requerido Descripción
grant_type "client_credentials" Sí Debe ser exactamente client_credentials.
client_id string Sí Identificador de cliente emitido.
client_secret string Sí Secreto de cliente emitido.
scope string No Scopes separados por espacio. Ejemplo: b2b:read.

Respuesta (data)

Campo Tipo Descripción
access_token string JWT firmado para usar como Bearer token.
token_type "Bearer" Siempre Bearer.
expires_in number Tiempo de vida en segundos.
scope string Scopes concedidos, separados por espacio.
companyId string UUID de la empresa asociada al token.
clientId string Identificador del cliente.

Formato de respuestas

Campo Tipo Descripción
success boolean Resultado de la operación.
error { code: string; message: string } | null Solo presente cuando success es false.
data any Carga útil específica del endpoint.
meta any | null Metadatos opcionales.

Ejemplo de solicitud de token

curl -X POST "https://xapi.madebyblume.com/v1/i/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=TU_CLIENT_ID&client_secret=TU_CLIENT_SECRET&scope=b2b:read"

Referencia

Endpoints

Endpoints públicos actuales bajo /v1/i.

Catálogo · Lista de productos

POST /v1/i/products Scope: b2b:read

Devuelve la lista de productos del catálogo disponible para el cliente autenticado.

Respuesta (data)

Devuelve Tipo Descripción
Producto[] array Lista de productos.

El cuerpo puede enviarse vacío ({}) o sin cuerpo.

Producto

Campo Tipo Descripción
referenceCodestringCódigo de referencia del producto.
colorCodestringCódigo del color.
pricenumberPrecio regular.
discountPricenumberPrecio con descuento cuando aplica.
titlestringNombre o título del producto.
positionnumberPosición usada para ordenamiento.
externalIdnumberIdentificador externo del producto.
keywordsstringPalabras clave asociadas al producto.
descriptionstringDescripción del producto.
brandstringMarca.
productTypestringTipo de producto.
familystringFamilia del producto.
subFamilystringSubfamilia del producto.
colorstringNombre descriptivo del color.
genderstringSegmento o género.
modelstringModelo.
stylestringEstilo.
sizestringTalla.
imagesstring[]URLs absolutas de imágenes.

Ejemplo de solicitud

curl -X POST "https://xapi.madebyblume.com/v1/i/products" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{}"

Catálogo · Detalle de producto

POST /v1/i/products/expand Scope: b2b:read

Devuelve variantes por color, colores disponibles e imágenes para una referencia específica.

Cuerpo

Campo Tipo Requerido Descripción
referenceCode string Sí Código de referencia del producto.
colorCode string Sí Código del color solicitado.

Respuesta (data)

Campo Tipo Descripción
products ProductoDetalle[] Variantes para el color solicitado.
colorVariations ProductoColor[] Colores disponibles para la referencia.
images string[] URLs de imágenes, con comportamiento de imágenes unificadas cuando aplica.

ProductoDetalle

Campo Tipo Descripción
referenceCodestringCódigo de referencia del producto.
colorCodestringCódigo del color.
colorstringNombre del color.
titlestringNombre o título del producto.
descriptionstringDescripción del producto.
productTypestringTipo de producto.
sizestringTalla.
brandstringMarca.
modelstringModelo.
stylestringEstilo.
familystringFamilia.
subFamilystringSubfamilia.
genderstringSegmento o género.
pricenumberPrecio regular.
discountPricenumberPrecio con descuento.
stocknumberInventario disponible.
keywordsstringPalabras clave asociadas.
positionnumberPosición usada para ordenamiento.
externalIdnumberIdentificador externo.
barCodestringCódigo de barras.

ProductoColor

Campo Tipo Descripción
referenceCodestringCódigo de referencia del producto.
colorCodestringCódigo del color.
colorstringNombre descriptivo del color.

Ejemplo de solicitud

curl -X POST "https://xapi.madebyblume.com/v1/i/products/expand" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceCode": "ABC123",
    "colorCode": "001"
  }'

Soporte

¿Necesita ayuda para integrar?

Escríbanos para solicitar credenciales, revisar scopes o coordinar pruebas de integración.

Ideal si su equipo necesita validar autenticación, consumo del catálogo o casos de uso específicos.

Contactar soporte Solicitar demo
Documentación técnica de la API de Blume
Documentación clara para equipos que necesitan integrar rápido y bien.

¿Quiere integrar Blume con su operación actual?

Le ayudamos a definir credenciales, alcance y el flujo técnico correcto para su caso.

Solicitar demo Hablar con soporte

Tecnología avanzada, hecha simple.

Conecte catálogo, inventario, integraciones y datos sobre una base clara para su equipo técnico y comercial.

Solicitar demo Ver recursos