Afeta
Times que integram com a API do Matcher, especialmente clientes que fazem parse de erros ou tentam novamente requisições com chaves de idempotência.
O que mudou
A documentação agora declara corretamente que os erros do Matcher usam um envelope de problema RFC 9457 com
title, status, detail e um code estável; detalhes de validação por campo usam um array errors. Ela também documenta o formato da chave de idempotência (de 1 a 128 caracteres que correspondem a ^[A-Za-z0-9:_-]+$) e o comportamento de retentativa para MTCH-0015 e MTCH-0018.
Esta é uma correção de documentação; o comportamento de runtime não mudou.
Impacto
Classificação: Ação necessária. Clientes que fazem parse dos campos anteriores
message ou details, ou geram chaves sem essas restrições, devem se alinhar ao contrato real.
O que você precisa fazer
1
Atualize o tratamento de erros para ler
detail, status e errors quando aplicável.2
Valide as chaves de idempotência geradas contra as restrições documentadas.
3
Revise as retentativas de
MTCH-0015 e MTCH-0018 antes da próxima versão da sua integração.