Afecta a
Equipos que usan la documentación pública de Matcher para implementar, revisar o mantener integraciones. Esta actualización se aplica al portal de documentación pública. No cambia el comportamiento de la API en runtime.
El portal de documentación pública es la referencia de cara al cliente. No se recomienda tratar los archivos fuente del repositorio como artefactos de integración ni como especificaciones de API descargadas para uso del cliente.
Qué cambió
Rutas de reglas de comisiones
La referencia pública de API ahora muestra las rutas reales de reglas de comisiones de Matcher. Cinco endpoints de reglas de comisiones estaban documentados antes bajo un prefijo fantasma/v1/config/.... El portal de documentación ahora apunta a las rutas /v1/contexts/... y /v1/fee-rules/... que funcionan.
Nombres de esquemas y campos
La referencia ahora sigue los DTO de Go y los tags JSON que usa el binariov2.1.1 publicado.
Limpieza principal:
- 36 nombres de campos pasaron de
snake_caseacamelCase. - 9 esquemas se renombraron a nombres canónicos de Go.
- Los esquemas
Inputse renombraron aRequestdonde eso coincide con la convención de Go. - Se actualizaron los enlaces
$refy los arreglosrequired.
Wrappers fantasma eliminados
La documentación ya no muestra wrappers ni esquemas duplicados que la API no devuelve. Por ejemplo,AdjustmentResponse ahora muestra los campos en línea en lugar de un wrapper adjustment inexistente. CloneContextResponse ahora apunta al esquema canónico de contexto de conciliación y usa feeRulesCloned.
Campos y esquemas faltantes
Se agregaron al portal de documentación campos y esquemas presentes en los DTO de Go, incluidos campos del log de auditoría, campos puente de la solicitud de extracción, campos del informe de variación y esquemas auxiliares de exportación.Impacto
Esta es una actualización de documentación. Reduce la desviación entre la referencia pública y la API de Matcher publicada. Si tu integración ya funciona, esta nota de release por sí sola no requiere migración. Si usas la documentación para generar ejemplos, revisar rutas o verificar nombres de campos, usa el portal de documentación actualizado.
Qué debes hacer
1
Revisa las rutas de reglas de comisiones de Matcher antes de tu próximo cambio de integración.
2
Usa los nombres actualizados de campos y esquemas al leer la documentación pública.
3
No trates los archivos fuente del repositorio como artefactos de integración de cliente. Usa el portal de documentación como la referencia de cara al cliente.