Afeta
Equipes que integram com a API do Matcher, especialmente clientes que interpretam erros ou repetem requisições com chaves de idempotência.
O que mudou
A documentação agora informa corretamente que os erros do Matcher usam um envelope de problema RFC 9457 com
title, status, detail e um code estável; os detalhes de validação de campo usam um array errors. Ela também documenta o formato da chave de idempotência (1–128 caracteres que correspondem a ^[A-Za-z0-9:_-]+$) e o comportamento de nova tentativa para MTCH-0015 e MTCH-0018.
Esta é uma correção da documentação; o comportamento de runtime não mudou.
Impacto
Classificação: Ação necessária. Os clientes que interpretam os antigos campos
message ou details, ou que geram chaves de idempotência sem as restrições documentadas, devem ser alinhados ao contrato real.
O que você precisa fazer
1
Atualize o tratamento de erros para ler
detail, status e errors no nível do campo, quando aplicável.2
Valide as chaves de idempotência geradas contra as restrições documentadas de tamanho e de caracteres.
3
Revise o tratamento de novas tentativas para
MTCH-0015 e MTCH-0018 antes do próximo release de integração.