> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Contrato de erros e idempotência do Matcher

> A documentação do Matcher agora descreve o envelope de erro RFC 9457 e os requisitos de nova tentativa com idempotência.

10 de agosto de 2026Correção da documentaçãoAção necessária

## 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

***

**Step 1**

Atualize o tratamento de erros para ler `detail`, `status` e `errors` no nível do campo, quando aplicável.

**Step 2**

Valide as chaves de idempotência geradas contra as restrições documentadas de tamanho e de caracteres.

**Step 3**

Revise o tratamento de novas tentativas para `MTCH-0015` e `MTCH-0018` antes do próximo release de integração.

### Prazo

Sem prazo imposto pelo produto. Conclua a revisão antes do próximo release do seu cliente Matcher.

## Recursos

***

* [Lista de erros do Matcher](https://docs.lerian.studio/pt/reference/products/matcher/matcher-error-list.md)
* [Novas tentativas e idempotência](https://docs.lerian.studio/pt/reference/retries-idempotency.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.