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

Crea una API key desde API keys en el desplegable del usuario.
Importa proyectos con POST /api/v1/projects.
Importa recursos con POST /api/v1/resources.
Añade un contrato inicial al crear cada recurso cuando tengas la capacidad disponible.
Lee proyectos o recursos para sincronizar asignaciones ya hechas en Kordia.
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": []
}