Skip to main content
8 de maio de 2026 Atualização da documentação Revisão recomendada

​
Afeta

Equipes que usam a documentação pública do Matcher para implementar, revisar ou manter integrações. Esta atualização se aplica ao portal público de documentação. Ela não muda o comportamento da API em runtime.
O portal público de documentação é a referência voltada ao cliente. Recomenda-se que os arquivos-fonte do repositório não sejam tratados como artefatos de integração nem como especificações de API baixadas para uso do cliente.

​
O que mudou

​
Rotas de regras de tarifas

A referência pública da API agora mostra as rotas reais de regras de tarifas do Matcher. Cinco endpoints de regras de tarifas estavam documentados sob um prefixo fantasma /v1/config/.... O portal de documentação agora aponta para as rotas funcionais /v1/contexts/... e /v1/fee-rules/....

​
Nomes de schemas e de campos

A referência agora segue os DTOs em Go e as tags JSON usadas pelo binário v2.1.1 publicado. Principais limpezas:
  • 36 nomes de campos passaram de snake_case para camelCase.
  • 9 schemas foram renomeados para os nomes canônicos em Go.
  • Schemas Input foram renomeados para Request onde isso corresponde à convenção em Go.
  • Os links $ref e os arrays required foram atualizados.

​
Wrappers fantasmas removidos

A documentação não mostra mais wrappers nem schemas duplicados que a API não retorna. Por exemplo, AdjustmentResponse agora mostra os campos inline em vez de um wrapper adjustment inexistente. CloneContextResponse agora aponta para o schema canônico de contexto de conciliação e usa feeRulesCloned.

​
Campos e schemas ausentes

Campos e schemas presentes nos DTOs em Go foram adicionados ao portal de documentação, incluindo campos de log de auditoria, campos de ponte da requisição de extração, campos do relatório de variação e schemas auxiliares de exportação.

​
Impacto

Esta é uma atualização de documentação. Ela reduz a divergência entre a referência pública e a API do Matcher publicada. Se sua integração já funciona, nenhuma migração é necessária apenas por esta nota de release. Se você usa a documentação para gerar exemplos, revisar rotas ou conferir nomes de campos, use o portal de documentação atualizado.

​
O que você precisa fazer

1
Revise as rotas de regras de tarifas do Matcher antes da sua próxima mudança de integração.
2
Use os nomes atualizados de campos e schemas ao ler a documentação pública.
3
Não trate os arquivos-fonte do repositório como artefatos de integração do cliente. Use o portal de documentação como a referência voltada ao cliente.

​
Prazo

Nenhum.

​
Por quê

A referência anterior misturava o comportamento real do Matcher com rotas obsoletas, schemas duplicados e campos que não correspondiam aos DTOs publicados. A nova versão é mais clara e mais difícil de ler errado.

​
Recursos