API REST
Gredit expone una API REST bajo el namespace /api/v1/ para consultar datos del sistema de forma programática. La autenticación se realiza mediante JWT (JSON Web Tokens).
Autenticación
La API utiliza tokens JWT para autenticar las peticiones. El token debe incluirse en el header Authorization de cada request:
Authorization: Bearer <token>
Endpoints disponibles
Casos por guion
Obtiene los casos (issues) generados por un guion específico.
GET /api/v1/scripts/:id/issues
Parámetros:
| Parámetro | Tipo | Descripción |
|---|---|---|
id | integer | ID del guion |
Casos por estado
Obtiene un resumen de casos agrupados por estado.
GET /api/v1/scripts/issues_by_status
Rutas internas relevantes
Además de la API pública, Gredit expone rutas internas para la operación del sistema:
| Ruta | Descripción |
|---|---|
POST /script/api_issues | Obtener casos de un guion (uso interno) |
GET /home/api_issues_by_status | Dashboard de casos por estado |
POST /issues/exports | Exportar casos a archivo |
SAML endpoints
Para la integración SAML, Gredit expone:
| Ruta | Descripción |
|---|---|
GET /saml/:tenant_name/auth | Iniciar autenticación SAML |
POST /saml/:tenant_name/callback | Callback del IdP |
GET /saml/:tenant_name/metadata | Metadata del SP |
Ejemplo de uso
# Obtener casos de un guion
curl -H "Authorization: Bearer $TOKEN" \
https://gredit.example.com/api/v1/scripts/42/issues
# Obtener casos por estado
curl -H "Authorization: Bearer $TOKEN" \
https://gredit.example.com/api/v1/scripts/issues_by_status