Registro de cambios
Qué cambió en la documentación para desarrolladores y, cuando abra, en la API de Matchai: endpoints nuevos, cambios y obsolescencias, primero lo más reciente.
Esta página enumera los cambios que importan a quienes construyen sobre Matchai, primero los más recientes. Hoy cubre la documentación para desarrolladores. Cuando la API de Matchai abra, también registrará cada cambio de la API, incluida cada obsolescencia, antes de que el cambio entre en vigor.
2026-10-20
Documentación para desarrolladores publicada; la API de Matchai está en diseño (próximamente)
La documentación para desarrolladores es pública.
Disponible hoy
- El servidor MCP y sus herramientas públicas, para asistentes de IA.
- La búsqueda de anuncios en
/ask, para buscar en lenguaje natural entre los anuncios publicados. - Las páginas legibles por IA:
llms.txt, copias en Markdown, datos estructurados y mapas del sitio en cada host de Matchai. - El contrato OpenAPI de estos endpoints públicos en
https://matchai.co/openapi.json. - Los límites de solicitudes de estos recursos públicos.
Próximamente
La API de Matchai está en diseño. Se documenta ahora, como vista previa, para que los socios y los desarrolladores puedan planificar. Cada página y cada endpoint están marcados como Próximamente, y nada de esto funciona todavía.
- La API en
https://api.matchai.co/v1: anuncios, contactos, conversaciones, calendario, documentos, sitios y la Página Matchai. Consulta la referencia de la API. - Claves de API para tu propia cuenta, y Conectar con Matchai (OAuth 2.1) para las apps que dan servicio a otros profesionales.
- Acciones finales y aprobaciones, para que enviar, publicar, pagar y eliminar pidan primero la aprobación del titular de la cuenta.
- Webhooks, y herramientas autenticadas en el servidor MCP.
- El formato de los errores, los encabezados de límite de solicitudes y las reglas de versionado que seguirá la API.
El contrato de la vista previa se puede descargar en https://matchai.co/docs/openapi/matchai-v1.yaml. Los detalles todavía pueden cambiar antes de que abra la API.
Cómo se verán las próximas entradas
Las entradas tienen fecha y aparecen primero las más recientes. En cada fecha, los cambios se agrupan según cómo te afectan:
| Grupo | Qué contiene |
|---|---|
| Agregado | Endpoints, campos, alcances, tipos de eventos y herramientas nuevos |
| Cambiado | Comportamiento que cambió sin romper una integración correcta |
| Obsoleto | Algo que se eliminará, qué lo reemplaza y cómo hacer la transición |
| Eliminado | Algo que se marcó como obsoleto antes y que ya no existe |
| Corregido | Comportamiento que no coincidía con la documentación y que ya se corrigió |
Un cambio que puede romper una integración correcta se marca como Incompatible y se anuncia en Obsoleto antes de que ocurra. Consulta versionado para saber qué se considera incompatible.
Una entrada se ve así. El ejemplo no es un cambio real:
## 2027-01-15
### Added
- `GET /v1/…`: what it returns, and the scope it needs.
### Deprecated
- **Breaking, in a later version.** What is retired, what replaces it, and how to move across.