01
Importar a coleção
No Postman: File → Import → Link. Cole o URL do ficheiro JSON a partir do botão de descarregamento acima. O Postman adiciona a coleção — com as respetivas variáveis — ao seu espaço de trabalho.
Programadores · Coleção Postman
Importe a coleção. Em cinco minutos está dentro.
Uma coleção Postman pré-configurada com exemplos práticos para a Fabrixa Integration API. Introduza as suas credenciais, percorra os pedidos e veja respostas reais da API antes de escrever uma única linha de código de integração. Acompanhada ao longo das versões — a coleção é atualizada sempre que a API é atualizada.
O que faz parte da coleção
Cada endpoint, com payloads de exemplo.
Organizados em pastas por recurso. Cada pedido inclui um corpo de exemplo já preenchido, os dois cabeçalhos de autenticação pré-definidos e uma resposta de exemplo guardada — para que possa pré-visualizar o formato da resposta antes de enviar o pedido.
Autenticação e produtos
- GET /ping — verificar credenciais
- GET /produtos — listar e paginar (SKU + variant_id)
- Esquemas de campos completos na referência do Swagger
Encomendas
- POST /orders — criar uma encomenda
- GET /orders/{id}/fulfillments — acompanhar a produção
Studio e webhooks
- GET /v2/studio/customizations/{key}/preview
- Payload do webhook + verificação HMAC (exemplo)
Importar em 30 segundos
File → Import → Link → colar URL.
02
Abra o separador «Variáveis»
A coleção inclui as suas próprias variáveis — base_url está pré-preenchido; access_token e application_key são espaços reservados. Não é necessário um ficheiro de ambiente separado.
03
Cole as suas chaves
Insira o token de acesso da aplicação e a chave da aplicação de um canal de vendas no seu painel de controlo, clique em «Guardar» e todas as solicitações serão autenticadas.
Variáveis de ambiente
O que está no ficheiro env.
Um URL base, duas credenciais, integradas na coleção. Crie a aplicação com base num canal de vendas e, depois, cole as chaves do seu canal ativo quando lançar a aplicação — a mesma coleção, os mesmos pedidos.
Variáveis da coleção
{
"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"
}
Autenticação pré-configurada
Ambos os cabeçalhos de autenticação, predefinidos em cada pedido.
Cada pedido implica Authorization: Bearer {{access_token}} e X-Application-Key: {{application_key}}, extraídas das variáveis de coleção — sem necessidade de configurar cabeçalhos para cada pedido. Para mudar de um canal de vendas para outro, basta editar essas duas variáveis: a mesma coleção, chaves diferentes.
Exemplos resolvidos
Cada pedido é enviado com um corpo de amostra e uma resposta guardada.
A coleção não se resume apenas a esboços de URL — cada pedido inclui um corpo de exemplo detalhado, pelo que pode clicar em «Enviar» e ver dados reais. As respostas de exemplo guardadas ficam no painel «Exemplos» para consulta offline.
Verificar autenticação
Confirma, antes de mais, se o seu Application Access Token e a sua Application Key são válidos. Devolve 200 em caso de sucesso e 401 se faltar algum cabeçalho.
Listar produtos
Pedido de catálogo paginado. Devolve os produtos página a página no envelope de links / meta / dados, com o código SKU e o identificador da variante por artigo.
Criar uma encomenda
Corpo de exemplo para uma encomenda de uma T-shirt, com um ficheiro PDF de origem, o cliente e a morada de entrega. Clique em «Send» para ver a encomenda criada com o respetivo ID Fabrixa.
Acompanhar a produção
Apresenta as etapas de produção por artigo (impressão, fixação, lavagem, costura) com os estados pendente, em curso, concluído e rejeitado para uma encomenda efetuada.
Studio preview
Devolve a imagem de pré-visualização renderizada de uma personalização do Studio guardada — basta inseri-la diretamente na miniatura do carrinho.
Verificação da assinatura
Um exemplo prático de como recalcular a assinatura HMAC-SHA256 e compará-la com a x-webhook-signature antes do processamento.
Controlo de versões
A coleção é atualizada quando a API é atualizada.
Cada lançamento da API disponibiliza uma coleção atualizada no mesmo URL. Reimporte para obter novos endpoints e exemplos de payloads — os pedidos existentes na sua versão guardada continuam a funcionar até que esse endpoint seja efetivamente descontinuado.
URL estável
O URL do JSON da coleção é permanente. Ao reimportar, é obtida a versão mais recente — o URL nunca muda entre versões.
Referência ao Changelog
Consulte o registo de alterações para as notas da versão API correspondentes - o que foi movido, o que foi adicionado, o que está obsoleto.
Política de descontinuação
Os endpoints têm um período de obsolescência de 12 meses. A coleção assinala os pedidos obsoletos na descrição, para que sejam difíceis de ignorar antes que algo deixe de funcionar.
Descarregar e iniciar
Descarregue a coleção. Faça o seu primeiro pedido.
Importe a coleção, introduza as credenciais do seu canal de vendas e envie o seu primeiro pedido em poucos minutos — não é necessário qualquer código de integração para começar a explorar.