El backend publica el contrato canónico en /openapi.json. El proxy inverso incluido en la configuración de despliegue expone también las interfaces interactivas en /docs y /redoc, sin convertir esta página en una simulación de la API.
Principios del contrato
- versionado bajo
/api/v1; - paginación, filtros y códigos de error consistentes;
- ETags y caché donde sean seguros;
- atribución y licencia por fuente o campo cuando sea necesario;
- límites de uso y endpoints administrativos separados.
Endpoints públicos publicados
Este inventario resume las rutas del router público actual. OpenAPI es la referencia canónica para parámetros, esquemas y respuestas.
GET /api/v1/mattersGET /api/v1/matters/{id}GET /api/v1/matters/{id}/timelineGET /api/v1/matters/{id}/measuresGET /api/v1/matters/{id}/changesGET /api/v1/matters/{id}/positionsGET /api/v1/matters/{id}/implementationGET /api/v1/matters/{id}/votesGET /api/v1/matters/{id}/sourcesGET /api/v1/votesGET /api/v1/votes/{id}GET /api/v1/actorsGET /api/v1/actors/{id}GET /api/v1/sources/{id}GET /api/v1/source-spans/{id}GET /api/v1/searchPOST /api/v1/impact/evaluate
Estado
Estas rutas están publicadas por el backend. La disponibilidad efectiva en cada entorno depende de que su proxy exponga el backend; cualquier función ausente del OpenAPI servido en ese entorno debe considerarse no disponible.