Cada release de API. Cada breaking change. Registado.
A Fabrixa lança a API e as atualizações da plataforma com uma periodicidade previsível. Todas as versões são publicadas aqui em primeiro lugar — o que mudou, quais são as novidades, o que está a ser descontinuado e quando é que deixará de funcionar. Consulte esta página antes de atualizar.
O que mudou nas últimas semanas.
A mais recente em primeiro lugar. Cada entrada está datada, identificada com a versão semver e dividida nas categorias padrão: Adicionado / Alterado / Obsoleto / Removido / Corrigido / Segurança.
- CHANGEDNotícia de última hora: o caminho de base foi movido para
/v2/integration. Os endpoints da v1 foram substituídos — as integrações existentes da v1 continuam a funcionar durante o período de descontinuação; consulte o guia de integração. - CHANGEDNotícia de última hora: A autenticação é agora composta por dois cabeçalhos —
Authorization: Bearer(Token de acesso da aplicação) maisX-Application-Key. A autenticação v1 com um único token já não é aceite. - ADDEDFabrixa Studio — personalizador de produtos de marca branca incorporável: incorporar através de iframe, anexar um design guardado a uma linha de encomenda com
cart_item_key, e obter uma pré-visualização a partir de/v2/studio/customizations/{key}/preview. - CHANGEDResposta padrão nos pontos finais da lista:
links/meta/datacom links de paginação. - CHANGEDWebhooks consolidados em
order.createdeorder.updated, assinado comx-webhook-signature(HMAC-SHA256) e marcado comx-webhook-topic. - CHANGEDLimite de requisições definido em 30 por aplicação por minuto, apresentado através de
X-RateLimit-LimiteX-RateLimit-Remainingcabeçalhos.
- ADDED
GET /v1/products/:id/pricing- Prever o preço unitário nos níveis de volume por SKU. - CHANGEDA payload do webhook de encomendas inclui agora um
production_hubcampo (PT, ES ou NL). Compatível com versões anteriores.
- ADDEDProcesso de personalização em cinco modalidades para roupa de cama, toalhas de mesa e acessórios: texto, nome, números, imagens e campos de dados dinâmicos.
- ADDED
order.failedevento de webhook com motivos de erro estruturados (rejeição do material gráfico, tecido esgotado e outros semelhantes). - FIXEDCaso extremo de paginação em
GET /v1/ordersquando a filtragem por estado atravessa os limites da página.
- ADDEDAlmofada para exterior, toalha de mesa e pufe SKUs para utilização no exterior em materiais sintéticos. Disponível através de
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64campo no corpo da ordem — indique, em vez disso, o URL do ficheiro de origem. Data prevista para remoção: v1.20.0 (28 de março de 2027). - SECURITYO esquema de assinatura do Webhook foi reforçado. A variante HMAC anterior mantém-se válida até à versão v1.18.0; a partir daí, o novo método de assinatura será aplicado automaticamente.
- ADDEDCategoria de roupa de cama (capas de edredão para 1 pessoa / 2 pessoas / camas individuais, colchas, lençóis com elástico) no hub espanhol.
- ADDEDGuardanapo de sublimação SKUs no centro de distribuição holandês, com um prazo de entrega garantido de 2 a 3 dias úteis.
- CHANGEDO ponto final da encomenda aceita agora
recipient.countrycomo ISO 3166-1 alfa-2; a alternativa alfa-3 foi removida.
Edições anteriores disponíveis mediante pedido — e-mail developers@fabrixa.com.
SemVer, com alterações que quebram a compatibilidade de forma conservadora.
Alterações de rutura nos endpoints existentes
Raro. Anunciado 12 meses antes do lançamento. A versão principal anterior continua a ser suportada durante 12 meses após o lançamento da nova versão principal. Não eliminamos versões principais de ânimo leve.
Novos pontos finais, campos e comportamentos
Adições compatíveis com versões anteriores. O código existente continua a funcionar sem alterações. A maioria das versões são menores, com uma periodicidade de cerca de duas a quatro semanas.
Correcções de erros, desempenho, segurança
Estritamente sem impacto na funcionalidade. Implementado de forma contínua sem aviso prévio e registado no registo de alterações após a implementação.
12 meses desde o aviso de depreciação até à remoção.
Quando marcamos um campo, um endpoint ou um comportamento como obsoleto, a entrada no registo de alterações identifica-o como tal DEPRECATED e indica a versão e a data previstas para a remoção. A funcionalidade obsoleta continuará a funcionar durante, pelo menos, 12 meses após o aviso.
Enviamos três notificações de aviso — seis meses, três meses e um mês antes da remoção — para o endereço de e-mail registado para a chave API.
Os endpoints obsoletos também devolvem um X-Fabrixa-Deprecation cabeçalho de resposta que indica o caminho de migração, para que fique visível nos seus registos.
Como acompanhar as alterações.
Não é preciso ligar nenhum feed — esta página é a fonte de informação oficial. Veja aqui como se manter a par de tudo o que afeta a sua integração.
Consulte aqui primeiro
Todas as versões são publicadas nesta página, com a mais recente no topo. Adicione-a aos favoritos e consulte-a antes de atualizar uma dependência ou lançar uma nova integração.
Uma pista desimpedida
Quando algo está a ser descontinuado, a respetiva entrada é marcada DEPRECATED com a versão e a data previstas para a remoção — aviso prévio, no contexto.
Pergunte sobre uma alteração
Está a planear uma alteração ou uma migração para uma versão principal? Um engenheiro de soluções pode explicar-lhe os prazos e o impacto da sua integração.
Quando as alterações de rutura podem ser enviadas.
Os lançamentos de versões principais são agendados para períodos específicos, de modo a não coincidirem com as datas de lançamento dos produtos dos clientes nem com as épocas de pico das vendas a retalho. Na maioria dos anos, não se verificam lançamentos de versões principais.
Fevereiro e setembro são os períodos típicos para a implementação de alterações significativas — ambos após a época alta do retalho e antes do pico, o que dá aos integradores tempo para efetuar a migração antes da sua próxima grande entrega.
Novembro–dezembro (época festiva), março–maio (Fespa e lançamentos da primavera) e as duas semanas que antecedem eventos conhecidos do setor são períodos em que não são permitidas alterações que provoquem falhas. Continuam a ser lançadas correções, mas não são introduzidas alterações de comportamento, quer menores quer maiores.
A engenharia de soluções orienta os integradores através dos principais obstáculos.
Para mudanças de versão principais, publicamos um guia de migração juntamente com as notas de lançamento. A equipa de engenharia de soluções também disponibiliza sessões de apoio à migração gratuitas de 30 minutos para qualquer parceiro de integração ativo durante o período de descontinuação — marque a sua sessão através da página «contact-engineer». Os clientes empresariais beneficiam de apoio dedicado à migração no âmbito do seu MSA, além de acesso antecipado à nova versão principal num canal de vendas de teste 90 dias antes da disponibilização ao público.
Verifique aqui antes de atualizar.
Todas as versões são publicadas aqui em primeiro lugar — o que mudou e quando é que deixam de funcionar. As funcionalidades em desuso vêm acompanhadas de um período de transição, e as atualizações para versões principais incluem apoio à migração.