01
Importar la colección
En Postman: File → Import → Link. Pega la URL JSON del botón de descarga que aparece más arriba. Postman añada la colección —junto con sus variables— a su espacio de trabajo.
Desarrolladores · Colección de Postman
Importe la colección. En cinco minutos está dentro.
Una colección de Postman ya preparada con ejemplos prácticos para la integración de Fabrixa con API. Introduzca sus credenciales, ve haciendo clic en las solicitudes y compruebe las respuestas reales de la API antes de escribir ni una sola línea de código de integración. Se mantiene actualizada en todas las versiones: la colección se actualiza al mismo tiempo que ea API.
Qué incluye la colección
Cada endpoint, con payloads de ejemplo.
Organizadas en carpetas por recurso. Cada solicitud incluye un ejemplo de cuerpo ya elaborado, los dos encabezados de autenticación preconfigurados y una respuesta de ejemplo guardada, para que puedas previsualizar el formato de la respuesta antes de enviarla.
Autenticación y productos
- GET /ping — comprobar las credenciales
- GET /products — lista y paginación (SKU + variant_id)
- Esquemas de campos completos en la referencia de Swagger
Pedidos
- POST /orders — crear un pedido
- GET /orders/{id}/fulfillments — seguimiento de la producción
Studio y webhooks
- GET /v2/studio/customizations/{key}/preview
- Carga útil del webhook + verificación HMAC (ejemplo)
Importe en 30 segundos
Archivo → Importar → Vincular → pegar la URL.
02
Abra la pestaña «Variables»
La colección incluye sus propias variables — base_url está rellenado de antemano; access_token y application_key Son marcadores de posición. No se necesita ningún archivo de configuración independiente.
03
Pegue sus claves
Introduzca el token de acceso de la aplicación y la clave de la aplicación de un canal de ventas en su panel de control, pulsa «Guardar» y todas las solicitudes se autenticarán.
Variables de entorno
Qué hay en el archivo env.
Una URL base y dos credenciales, integradas en la colección. Configúrelo para un canal de ventas y, a continuación, pega las claves de su canal en producción cuando lo pongas en marcha: la misma colección, las mismas solicitudes.
Variables de la colección
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Autenticación preconfigurada
Ambos encabezados de autenticación, preconfigurados en cada solicitud.
Cada solicitud conlleva Authorization: Bearer {{access_token}} y X-Application-Key: {{application_key}}, extraídas de las variables de la colección —sin necesidad de configurar los encabezados para cada solicitud—. Para cambiar de un canal de ventas a otro, basta con modificar esas dos variables: la misma colección, pero con claves diferentes.
Ejemplos resueltos
Cada solicitud se envía con un cuerpo de muestra y una respuesta guardada.
La colección no se limita a esbozos de URL: cada solicitud incluye un cuerpo de ejemplo completo, por lo que puede pulsar «Enviar» y ver datos reales. Las respuestas de ejemplo guardadas se encuentran en el panel «Ejemplos» para consultarlas sin conexión.
Verificar autenticación
Comprueba, antes de nada, que el token de acceso y la clave de la aplicación sean válidos. Devuelve el código 200 si la operación se realiza correctamente y el 401 si falta algún encabezado.
Ver productos
Solicitud de catálogo paginado. Devuelve los productos página por página en el contenedor de enlaces / meta / datos, con el código SKU y el identificador de variante de cada artículo.
Realizar un pedido
Ejemplo de contenido para un pedido de una camiseta, con un PDF de origen, los datos del cliente y la dirección de envío. Pulsa «Enviar» para ver el pedido creado con su identificador Fabrixa.
Seguimiento de la producción
Muestra los pasos de producción por artículo (impresión, fijación, lavado, costura) con los estados «pendiente», «en curso», «finalizado» y «rechazado» para un pedido realizado.
Vista previa de Studio
Devuelve la imagen de vista previa generada para una personalización de Studio guardada; puede colocarla directamente en la miniatura del carrito.
Comprobación de la firma
Un ejemplo práctico de cómo volver a calcular la firma HMAC-SHA256 y compararla con la firma «x-webhook-signature» antes del procesamiento.
Control de versiones
La colección se actualiza cuando lo hace ea API.
Cada lanzamiento de API incluye una colección actualizada en la misma URL. Vuelva a importarla para obtener los nuevos endpoints y los payloads de ejemplo; las solicitudes existentes en su versión guardada seguirán funcionando hasta que ese endpoint quede realmente obsoleto.
URL estable
La URL del JSON de la colección es permanente. Al volver a importarla, se obtiene la última versión; la URL nunca cambia entre una versión y otra.
Referencia al registro de cambios
Consulta el registro de cambios para obtener las notas de la versión API correspondientes: qué se ha movido, qué se ha añadido, qué está obsoleto.
Política de obsolescencia
Los endpoints disponen de un plazo de 12 meses antes de quedar obsoletos. La colección señala las solicitudes obsoletas en la descripción, por lo que es difícil pasarlas por alto antes de que se produzca algún fallo.
Descargar y empezar
Descargue la colección. Lance su primera solicitud.
Importa la colección, introduzca las credenciales de su canal de ventas y envíe su primera solicitud en cuestión de minutos; no hace falta escribir código de integración para empezar a explorar.