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