DEVOPS_MONITOR_API_INTEGRATION_CORE
La API de DevOps Monitor es un motor RESTful de alto rendimiento que proporciona las bases de control, sincronización y orquestación para todas las interfaces de usuario de Next.js, integraciones externas de Azure DevOps y automatizaciones de SRE.
01_API_SPECIFICATION
Toda comunicación con los servicios de DevOps Monitor se realiza mediante peticiones HTTPS cifradas (TLS 1.3), con intercambio de datos en formato JSON y autenticación basada en tokens web JSON (JWT).
+----------------------+ HTTPS REQUEST (JWT Bearer Token) +------------------------+
| Client UI (Next.js) | ---------------------------------------> | DevOps Monitor API Gateway
+----------------------+ +------------------------+
|
v
[ MICROSERVICES ROUTING ]
|
+------------------------------+------------------------------+
| | |
v v v
[ AUTH / ACCOUNT ] [ DORA METRICS ENGINE ] [ COGNITIVE SUPPORT ]
02_CORE_API_CHANNELS
Nuestra API se divide en cinco canales de operación optimizados para dar soporte a las necesidades más exigentes de tu equipo:
1. Autenticación y Perfiles (/accounts)
- Seguridad JWT: Gestión robusta de inicio de sesión, renovación de tokens de sesión y registro corporativo unificado.
- Gobernanza de Roles: Soporte nativo para Control de Acceso Basado en Roles (RBAC) con insignias operativas ("OP_ACTIVE").
2. Gestión de Workspaces (/workspaces)
- Aprovisionamiento de Espacios: Creación, purga segura y vinculación de múltiples proyectos de Azure DevOps bajo una sola suscripción.
- Tokens de Vinculación: Conexión programática de repositorios de código mediante tokens de acceso personal (PAT).
3. Telemetría de Fallos y DORA (/dashboard/reports)
- Failed Tasks Leaderboard: Entrega datos agrupados de tareas con mayor tasa de error, organizadas por repositorio, rama afectada y porcentaje de participación global.
- Pipeline Duration Trends: Historial agregativo de tiempos de ejecución y volumen de builds en formato tabular de alta precisión.
4. Soporte Cognitivo y Logs (/support)
- Ticket Ingest Engine (
/support/ticket/create): Permite el envío directo de logs de pipelines fallidos para ser procesados por nuestro equipo de ingenieros o escaneados por los agentes CrewAI.
5. Auditoría de Tokens y Claves (/settings/apikey)
- API Keys Provisioning: Emisión, revocación y auditoría de llaves de acceso para integrar DevOps Monitor con tus scripts locales de Bash o pipelines de Jenkins.
03_ROUTE_MAP_SUMMARY
A continuación, se presenta la matriz técnica de los endpoints principales integrados en la plataforma:
| Método | Endpoint | Autenticación | Propósito |
|---|---|---|---|
POST | /accounts/authenticate | Ninguna | Valida credenciales e inicia sesión de operador (JWT). |
POST | /accounts/register | Licencia | Registra una cuenta corporativa vinculada a una licencia activa. |
POST | /support/ticket/create | JWT Bearer | Ingiere un ticket de soporte con logs raw para análisis IA. |
GET | /dashboard/reports/global-failed | JWT Bearer | Retorna el ranking denso de fallas de compilación global. |
GET | /dashboard/billing/consumption | JWT Bearer | Retorna el historial de consumo detallado sin planes starter. |
POST | /dashboard/settings/apikey/create | JWT Bearer | Emite un token API seguro para integraciones personalizadas. |
04_HEADER_AUTHENTICATION
Para realizar peticiones a endpoints protegidos, debes incluir el token JWT en el encabezado Authorization con el prefijo Bearer.
# Ejemplo de llamada segura para consultar el leaderboard de fallas de tu Workspace:
curl -X GET "https://devsecops-monitor.newinntech.com/api/dashboard/reports/global-failed" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
SIGUIENTE PASO: Explora las secciones detalladas en el menú lateral para consultar especificaciones de esquemas JSON, códigos de respuesta HTTP y parámetros de filtrado para cada canal.