01
Pedidos
POST /v2/integration/orders
Envía un pedido con filas, PDF de origen, datos del cliente y dirección de envío. Devuelve el ID del pedido Fabrixa. Campos opcionales de etiqueta de envío y seguimiento.
documentación completa de la API
Un endpoint. Productos infinitos.
Cada SKU de Fabrixa, cada tejido, cada acabado: todo ello accesible a través de una única interfaz REST API documentada. Entrada y salida en formato JSON. Webhooks para cada cambio de estado. Claves API de autoservicio: cree un canal de ventas y empiece a desarrollar.
Lo que obtiene
Construido en torno a cómo funciona realmente la producción.
Una REST API documentada que refleja la plataforma: pedidos, fulfilment, personalización de Studio y webhooks. Entrada y salida en formato JSON. Úsalo junto con el panel de control o controla todo mediante programación.
02
Fulfilment
GET /orders/{id}/fulfillments
Extraiga el estado de producción por partida: cada paso (imprimir, fijar, lavar, coser) con estados pendiente / en curso / realizado / rechazado. O suscríbase a webhooks para push.
03
Estudio
Incrustar iframe
Integre Fabrixa Studio en su tienda online. Los clientes personalizan los productos en tiempo real, con eventos «postMessage» para añadir al carrito y volver atrás, además de una URL de vista previa para las miniaturas del carrito.
04
Webhooks
order.created / order.updated
Dos temas: payloads firmadas con HMAC-SHA256, cuerpo de pedido completo y entrega con 10 retries y back-off.
Inicio rápido
Realice un pedido en un POST.
Solicitud autenticada, payload validada, espacio reservado en la cola de producción. Confirmación en milisegundos: el pedido de su cliente ya está en proceso.
En la documentación técnica se incluyen el esquema completo, todos los endpoints, los códigos de error, los rate limits y los ejemplos de integración.
POST /v2/integration/orders
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "number": "ORD-2026-0142", "purchased_at": "2026-05-28 14:22:01", "rows": [ { "sku": "COF099191", "quantity": 1, "sources": [ { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" } ] } ], "customer": { "first_name": "Maria", "last_name": "Silva", "email": "maria@example.com", "phone": "+351912345678" }, "shipping_address": { "address": "Rua do Carmo 42", "city": "Lisboa", "postal_code": "1200-094", "country_code": "PT", "country": "Portugal" } }
Flujo de integración
En directo en dos semanas. Sin proxy, sin middleware.
Integración REST directa en su plataforma. Sin necesidad de SDK, sin servidor proxy ni conector de terceros. Protocolo HTTP estándar desde su entorno al nuestro.
01
Credenciales
Consiga un Application Access Token y una Application Key creando un canal de ventas en su panel de control. Ambos son obligatorios en cada solicitud: el token Bearer en el encabezado Authorization y la Application Key en el encabezado X-Application-Key.
02
Catálogo
Consulta la referencia de Swagger en tiempo real para encontrar las variantes SKUs de los productos que deseas vender, así como los patrones de filtrado y paginación.
03
Pedidos
Al finalizar la compra, envíe una solicitud POST con rows, sources (URL de los PDF), customer y shipping_address. Guarde el ID de pedido de Fabrixa que se le devuelva junto con su propia referencia de pedido.
04
Webhooks
Exponer un endpoint POST público. Firmamos cada carga con HMAC-SHA256 (x-webhook-signature) para que puedas verificar la autenticidad antes de procesarla.
05
Estudio
Opcional: inserte el iframe de Fabrixa Studio en la página de su producto. Los clientes personalizan en tiempo real; adjunte sus personalizaciones al pedido mediante un método POST.
Recursos para desarrolladores
Todo lo que su equipo de ingenieros necesita.
Referencia completa API
Documentación completa de los endpoints, esquemas de solicitud/respuesta, códigos de error, rate limits, autenticación, integración en Studio y contratos de webhooks, todo ello con una interfaz de Swagger en tiempo real.
Abrir la documentación →Desarrollar sobre un canal de ventas
Cree un canal de ventas específico sobre el que trabajar —envía pedidos de prueba, compruebe la entrega de los webhooks, valide los casos extremos— y, a continuación, redirija el tráfico real a su canal en producción. Sus claves estarán listas en el momento en que cree el canal, sin necesidad de realizar ninguna solicitud.
Cree su cuenta →Colección de Postman
Conjunto de solicitudes preconfiguradas con payloads de ejemplo y autenticación. Impórtelo a su flujo de trabajo de pruebas.
Obtenga la colección →
Seguridad
Autenticación de dos encabezados. Webhooks firmados. Con rate limit.
Prácticas estándar, sin sorpresas. Cada solicitud se autentica mediante un token «Bearer» y una clave de aplicación. Cada webhook lleva una firma HMAC para su verificación, con rate limits predecibles por aplicación.
Token de acceso a la aplicación
Bearer Token en la cabecera Authorization. Identifica la aplicación que llama.
Clave de aplicación
Se envía en el encabezado X-Application-Key. Ambos son obligatorios en cada solicitud; si falta alguno de ellos, se devuelve el código de error 401.
Cifrado TLS
Sólo HTTPS en api.fabrixa.com. Las solicitudes en texto plano se rechazan en el borde.
Firmas de webhook
Cada webhook está firmado con HMAC-SHA256 y se envía en el encabezado «x-webhook-signature». Compruébalo antes de procesarlo.
Rate limits
30 solicitudes por aplicación por minuto. En cada respuesta se devuelven los campos «X-RateLimit-Limit» y «X-RateLimit-Remaining».
Reintentos de webhook
Se realizan hasta 10 retries de entrega si la respuesta no es del tipo 2xx ni 3xx. El webhook se desactiva tras el décimo fallo.
Empiece a desarrollar
Cree un canal de ventas y empiece a desarrollar hoy mismo.
Regístrese, cree un canal de ventas y sus credenciales de API estarán listas al instante. ¿Necesita ayuda? Nuestros ingenieros de soluciones le responderán en un plazo de 24 horas; la mayoría de los equipos están operativos en dos semanas.