01
CATÁLOGO
GET /catalog
Puxe cada SKU, tecido, tamanho, acabamento no nosso sistema. Filtrar por categoria, material de base, certificação ou país de produção.
DOCUMENTAÇÃO API
Um ponto final. Produtos infinitos.
Cada Fabrixa SKU, cada tecido, cada acabamento - endereçável através de um REST API documentado. JSON in, JSON out. Webhooks para cada transição de estado. Chave de sandbox emitida no mesmo dia no contrato.
REST - JSON - WEBHOOKS - OPENAPI 3.1 - SANDBOX READY
O QUE RECEBE
Infraestrutura de produção como código.
Não é um painel de controlo com um botão. Um REST API documentado que os seus programadores integram uma vez e a sua plataforma é dimensionada sem intervenção manual.
02
ORDENS
POST /encomendas
Submeter uma encomenda com desenho, SKU, endereço de entrega, configuração opcional de marca branca. Devolve a identificação da encomenda e a data de envio prevista.
03
ESTADO
GET /orders/{id}
Obtenha o estado atual em qualquer altura: em fila de espera, impressão, costura, CQ, embalado, expedido. Ou subscreva webhooks para envio em tempo real.
04
WEBHOOKS
POST o seu ponto final
Enviamos eventos para o seu URL em cada transição de estado. Ciclo de vida do pedido, despacho, exceções, retornos. Cargas assinadas.
INÍCIO RÁPIDO
Efetuar uma encomenda num só POST.
Pedido autenticado, carga útil validada, espaço reservado na fila de produção. Confirmação de volta em milissegundos. A encomenda do seu cliente está agora em movimento.
O esquema completo, todos os pontos finais, códigos de erro, limites de taxa e exemplos de integração estão na documentação técnica.
Referência API completa →POST /v1/encomendas
// POST https://api.fabrixa.com/v1/orders // Autorização: Portador SUA_API_KEY { "sku": "vestuário.tee.unisexo.branco.m", "obra de arte": "https://cdn.you.com/art/9812.png", "quantidade": 1, "customer_ref": "ordem-1042", "expedir_para": { "nome": "Maria Silva", "rua": "Rua do Carmo 42", "cidade": "Lisboa", "código postal":"1200-094", "país": "PT" }, "white_label": { "etiqueta_pescoço": "marca-a", "etiqueta": "marca-reciclada", "embalagem": "marca-correio" }, "webhook": "https://you.com/hooks/fabrixa" }
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, nenhum conetor de terceiros. HTTP padrão da sua pilha para a nossa.
01
CAIXA DE AREIA
Obter credenciais de teste
Chave Sandbox API emitida no mesmo dia do contrato. O ambiente de teste é funcionalmente idêntico ao de produção.
02
CATÁLOGO
Mapear os seus produtos
Sincronize o nosso catálogo SKU na sua loja. Faça corresponder os SKUs da sua marca aos nossos SKUs de base.
03
ORDEM
Ligar o fluxo de encomendas
No checkout, envie um POST para /orders. Valide a resposta. Guarde o nosso ID de encomenda na sua encomenda de cliente.
04
WEBHOOKS
Subscrever eventos
Implementar um ponto final para receber actualizações de estado. Nós assinamos as cargas úteis; você verifica as assinaturas.
05
VIVA
Passagem à produção
Carregue na tecla API. As encomendas reais fluem. Clientes reais recebem o produto. Monitorização através de painel de controlo ou fluxo de webhook.
RECURSOS PARA PROGRAMADORES
Tudo o que a sua equipa de engenharia precisa.
Referência completa API
Documentação completa do ponto final, esquemas de pedido/resposta, códigos de erro, limites de taxa, autenticação. Especificações do OpenAPI 3.1 disponíveis para download.
Abrir documentos →Ambiente de caixa de areia
Funcionalmente idêntico à produção. Submeter encomendas de teste, verificar a entrega de webhooks, validar casos extremos. Emitido com a chave API.
Pedir acesso →Coleção Postman
Coleção de pedidos pré-configurada com exemplos de cargas úteis e autenticação. Importe para o seu fluxo de trabalho de teste.
Obter a coleção →
SEGURANÇA
Autenticação de portador, webhooks assinados, taxa limitada.
Práticas normalizadas, sem surpresas. Todos os pedidos são autenticados. Todos os webhooks assinados. Limites de taxa escalonados de acordo com o nível da sua conta.
Autenticação do portador
Todos os pedidos incluem o cabeçalho Authorization: Bearer YOUR_API_KEY.
TLS 1.3
Todo o tráfego API encriptado. HTTPS aplicado.
Assinaturas de webhook
Todos os webhooks são assinados com HMAC-SHA256. Verificar antes de processar.
Limites de taxas
Nível de amostragem: 60 req/min. Produção: 600 req/min. Escala: personalizada.
API rotação da chave
Rodar as chaves através do painel de controlo. Chaves de sandbox + produção separadas.
Pedir idempotência
POST /orders suporta o cabeçalho Idempotency-Key. Tentativas seguras.
COMEÇAR A CONSTRUIR
A chave da caixa de areia é emitida no próprio dia, mediante contrato.
Diga-nos qual é a sua pilha, a sua plataforma, o seu calendário. Concebemos o caminho de integração e orçamentamo-lo em 24 horas. A maioria das equipas está pronta em 2 semanas.