Novidades da API

Como a API evolui

A API pode ganhar, a qualquer momento, campos novos nas respostas e valores novos nos campos de valores fixos (enums). Seu sistema deve ignorar os campos que não conhece e tratar valores desconhecidos sem falhar.

As mudanças que afetam quem integra ficam registradas nesta página, da mais nova para a mais antiga.

3 de novembro de 2026

• As chamadas recusadas com 401 sem corpo (veja Erros comuns) e as chamadas a rotas inexistentes (404) deixaram de gastar ficha do limite de requisições. Os números do limite não mudaram.

28 de outubro de 2026

• A integração criada sem empresas escolhidas passou a acessar todas as empresas do grupo com contrato ativo e com a API de Integração no contrato. Antes, a chave dessa integração era recusada com 400 "Chave de integração inválida".

9 de outubro de 2026: primeira versão em produção

A autenticação por chave de integração e a API entraram em produção, com:

• geração do token em POST /auth/integracao, com validade de 24 horas;
• lista das empresas liberadas em GET /v1/empresa;
• consulta do pedido em aberto em GET /v1/pedido/{id}/aberto;
• aviso por webhook do evento OrcamentoCriado, com o webhook cadastrado pelo administrador do grupo (um ativo por evento e URL);
• limite de 100 requisições por grupo, com 5 fichas repostas a cada 3 segundos.

Mudou nesse dia, em relação às versões anteriores à produção:

• As rotas perderam o prefixo /integrador e os recursos passaram para o singular: /integrador/v1/empresas virou /v1/empresa. As rotas antigas não existem mais.
• O limite subiu de 10 para cerca de 100 requisições por minuto por grupo.
• O cadastro de webhooks deixou de ser feito pela integração, via API, e passou a ser só do administrador do grupo, no sistema.

Antes da produção

A API foi criada em 22 de setembro de 2026. Até 9 de outubro, a autenticação por chave de integração ainda não estava em produção. Nesse período:

• 22 de setembro de 2026: criação da API, com as rotas em /integrador/.
• 23 de setembro de 2026: lista das empresas liberadas, em /integrador/v1/empresas.
• 28 de setembro de 2026: limite de 10 requisições por minuto por grupo, com resposta 429 e header Retry-After.
• 6 de outubro de 2026: a integração passou a cadastrar os próprios webhooks pela API.
• 8 de outubro de 2026: aviso por webhook quando um orçamento é criado (OrcamentoCriado).