Visión general de la API

La API de AppArch tiene dos caras: el plano de control (autenticación, workspaces, paquetes, registro de proyectos) y la API de informes (endpoints protegidos por token donde los runners del analizador envían sus resultados).

Autenticación del runner

Los runners presentan un token bearer específico del proyecto generado al registrar el proyecto. El token está acotado a un único workspace + proyecto + módulo y puede revocarse desde el Gestor de credenciales.

POST /api/v1/reports
Authorization: Bearer apparch_proj_xxxxxxxx
Content-Type: application/json

Versionado

La API de informes está versionada bajo /api/v1/reports. Como los runners no pueden actualizarse en caliente en el entorno del cliente, esta superficie se mantiene estable entre versiones; los runners se fijan a una versión mayor.

Información del sistema

Puedes consultar la versión y el modo de despliegue de forma anónima:

GET /api/v1/system/info
→ { "version": "...", "deploymentMode": "SaaS", "serverTimeUtc": "..." }