API de Integraciones

La API de Kordia permite que una herramienta externa importe y consulte datos de planificación sin mover fuera de Kordia las reglas de asignación.

Base URL:

/api/v1

Especificación OpenAPI:

GET /api/openapi.json

Qué puedes hacer

| Recurso | Lectura | Creación | Actualización | Borrado | | --- | --- | --- | --- | --- | | Proyectos | Sí | Sí | No | No | | Recursos | Sí | Sí | No | No | | Contratos | Sí, dentro de recursos | Solo contrato inicial al crear recurso | No | No | | Asignaciones | Sí | No | No | No | | Usuarios y miembros | No | No | No | No |

Qué queda dentro de Kordia

Las asignaciones no se pueden mutar por API. La creación, edición y borrado de asignaciones se hace desde la aplicación porque depende de reglas de negocio que no queremos duplicar en integraciones externas.

Kordia valida:

• solapes por recurso y proyecto,
• capacidad contra contratos activos,
• límites diarios,
• ventanas temporales del proyecto,
• proyectos archivados,
• recálculos cuando cambian contratos,
• límites del plan contratado.

Flujo recomendado

1. Crea una API key desde API keys en el desplegable del usuario.
2. Importa proyectos con POST /api/v1/projects.
3. Importa recursos con POST /api/v1/resources.
4. Añade un contrato inicial al crear cada recurso cuando tengas la capacidad disponible.
5. Lee proyectos o recursos para sincronizar asignaciones ya hechas en Kordia.
6. Añade include=monthly_hours cuando necesites reporting mensual por recurso o proyecto.

Idempotencia práctica

Proyectos y recursos aceptan external_id opcional. Úsalo para guardar el identificador del sistema externo.

{
  "external_id": "employee-456"
}

Después puedes consultar por ese valor:

GET /api/v1/resources?external_id=employee-456

Formato de respuesta

Todas las respuestas de éxito devuelven un objeto con data.

{
  "data": {
    "id": 7,
    "name": "Ana García"
  }
}

Las listas devuelven data como array.

{
  "data": []
}