📄️ Requisitos
La Web API de Crono expone datos y operaciones a sistemas de terceros mediante una API REST versionada. La provee el módulo Crono.WebApi, que se apoya en el mismo catálogo de módulos que la aplicación web, de modo que cada módulo puede publicar sus propios endpoints.
📄️ Autenticación
Todas las peticiones a la Web API deben autenticarse. Crono usa un esquema de autenticación propio, llamado Api, y sobre él aplica la misma autorización por permisos que el resto del sistema. Las operaciones quedan además acotadas al usuario y la organización de la credencial.
📄️ La Web API en detalle
Esta página describe cómo está construida la Web API de Crono: el controlador base, el enrutado y versionado, la agrupación para la documentación, el tipo de medio y el modelo de errores.
📄️ Cambios importantes de versión
En el sistema de referencia, esta página documenta la migración de su Web API basada en OData a una nueva versión mayor (cambios de rutas, convenciones OData v4, formato de consultas $filter/$expand, etc.). La Web API de Crono no es OData: es una API REST versionada con Asp.Versioning, por lo que esos cambios concretos no aplican.
📄️ Ayuda y herramientas
La Web API se documenta y prueba con Swagger / OpenAPI. El módulo Crono.WebApi integra Swashbuckle para generar la documentación interactiva a partir de los propios controladores, y Markdig para renderizar descripciones en Markdown.
📄️ Apéndice
Referencia rápida de las convenciones transversales de la Web API de Crono. El detalle está en La Web API en detalle.
🗃️ Ejemplos
1 item