01
Encomendas
POST /v2/integration/orders
Envie uma encomenda com linhas, PDFs de origem, dados do cliente e morada de entrega. Devolve o ID da encomenda Fabrixa. Etiqueta de envio opcional e campos de rastreio.
Documentação da API
Um endpoint. Produtos infinitos.
Cada SKU Fabrixa, cada tecido, cada acabamento — acessíveis através de uma única REST API documentada. Entrada e saída em JSON. Webhooks para cada transição de estado. Chaves API self-service — crie um canal de vendas e comece a desenvolver.
O que recebe
Construído em torno da forma como a produção funciona efetivamente.
Uma REST API documentada que reflete a plataforma — encomendas, fulfilment, personalização do Studio e webhooks. Entrada e saída em JSON. Utilize-a em conjunto com o painel de controlo ou controle tudo programaticamente.
02
Fulfilment
GET /orders/{id}/fulfillments
Estado da produção por item de linha: cada passo (imprimir, fixar, lavar, coser) com estados pendente / em curso / concluído / rejeitado. Ou subscrever webhooks para envio.
03
Studio
Inserção de iframe
Incorpore a Fabrixa Studio na sua loja online. Os clientes personalizam os produtos em tempo real, com eventos «postMessage» para adicionar ao carrinho e voltar, além de um URL de pré-visualização para as miniaturas do carrinho.
04
Webhooks
order.created / order.updated
Dois tópicos, payloads assinados com HMAC-SHA256, corpo da encomenda completo, entrega com 10 tentativas e back-off.
Introdução rápida
Efetuar uma encomenda num só POST.
Pedido autenticado, payload validado, slot reservado na fila de produção. Confirmação recebida em milissegundos — a encomenda do seu cliente já está a ser processada.
O esquema completo, todos os endpoints, códigos de erro, rate limits e exemplos de integração encontram-se na documentação técnica.
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" } }
Fluxo de integração
Em direto dentro de duas semanas. Sem proxy, sem middleware.
Integração REST direta na sua plataforma. Sem necessidade de SDK, sem servidor proxy, sem conector de terceiros. HTTP padrão da sua pilha para a nossa.
01
Credenciais
Obtenha um token de acesso da aplicação e uma chave da aplicação criando um canal de vendas no seu painel de controlo. Ambos são necessários em todos os pedidos: o token «Bearer» na autorização e a chave da aplicação no campo «X-Application-Key».
02
Catálogo
Consulte a referência Swagger em tempo real para encontrar as variantes SKUs dos produtos que pretende vender, bem como os padrões de filtragem e paginação.
03
Encomendas
No momento do checkout, envie um pedido POST com as linhas, as fontes (URLs dos PDFs), o cliente e a morada de entrega. Guarde o ID da encomenda Fabrixa devolvido juntamente com a sua própria referência de encomenda.
04
Webhooks
Exponha um endpoint POST público. Assinamos cada payload com HMAC-SHA256 (x-webhook-signature) para que possa verificar a autenticidade antes do processamento.
05
Studio
Opcional: insira o iframe da Fabrixa Studio na sua página de produto. Os clientes personalizam em tempo real; as suas personalizações são anexadas à encomenda através de um pedido POST.
Recursos para programadores
Tudo o que a sua equipa de engenharia precisa.
Referência completa da API
Documentação completa dos endpoints, esquemas de pedido/resposta, códigos de erro, rate limits, autenticação, integração no Studio e contratos de webhooks — com uma interface Swagger em direto.
Abrir documentos →Desenvolver com base num canal de vendas
Crie um canal de vendas dedicado para testar — envie encomendas de teste, verifique a entrega dos webhooks, valide casos extremos — e, em seguida, direcione tráfego real para o seu canal ativo. As suas chaves ficam prontas assim que criar o canal — sem necessidade de solicitar nada.
Crie a sua conta →Coleção Postman
Conjunto de pedidos pré-configurado com payloads de exemplo e autenticação. Importe-o para o seu fluxo de trabalho de testes.
Obter a coleção →
Segurança
Autenticação de dois cabeçalhos. Webhooks assinados. Com rate limit.
Práticas padrão, sem surpresas. Cada pedido é autenticado através de um Bearer Token e de uma Application Key. Cada webhook é assinado com HMAC para verificação, com rate limits previsíveis por aplicação.
Token de acesso à aplicação
Bearer Token no cabeçalho Authorization. Identifica a aplicação que efetua a chamada.
Chave de aplicação
Enviados no cabeçalho X-Application-Key. Ambos são obrigatórios em todas as solicitações — a falta de qualquer um deles resulta num código de erro 401.
Encriptação TLS
Apenas HTTPS em api.fabrixa.com. Os pedidos de texto simples são rejeitados na extremidade.
Assinaturas de webhook
Cada webhook é assinado com HMAC-SHA256 e enviado no cabeçalho «x-webhook-signature». Verifique antes de processar.
Rate limits
30 pedidos por aplicação por minuto. Os campos «X-RateLimit-Limit» e «X-RateLimit-Remaining» são devolvidos em todas as respostas.
Novas tentativas de webhook
São permitidas até 10 tentativas de entrega em caso de resposta que não seja 2xx ou 3xx. O webhook é desativado após a 10.ª falha.
Comece a construir
Crie um canal de vendas e comece a desenvolvê-lo ainda hoje.
Registe-se, crie um canal de vendas e as suas credenciais API ficam prontas de imediato. Precisa de ajuda? Os nossos Solutions Engineers respondem no prazo de 24 horas — a maioria das equipas fica operacional em duas semanas.