Afecta a
Equipos que se integran con la API de Matcher, en especial los clientes que analizan errores o reintentan solicitudes con claves de idempotencia.
Qué cambió
La documentación ahora indica correctamente que los errores de Matcher usan un envelope de problema RFC 9457 con
title, status, detail y un code estable; los detalles de validación de campos usan un array errors. También documenta el formato de la clave de idempotencia (1–128 caracteres que coinciden con ^[A-Za-z0-9:_-]+$) y el comportamiento de reintento para MTCH-0015 y MTCH-0018.
Esta es una corrección de documentación; el comportamiento del runtime no cambió.
Impacto
Clasificación: Acción requerida. Los clientes que analizan los antiguos campos
message o details, o que generan claves de idempotencia sin las restricciones documentadas, deben alinearse con el contrato real.
Qué debes hacer
1
Actualiza el manejo de errores para leer
detail, status y los errors por campo cuando corresponda.2
Valida las claves de idempotencia generadas contra las restricciones documentadas de longitud y caracteres.
3
Revisa el manejo de reintentos para
MTCH-0015 y MTCH-0018 antes del próximo release de integración.