Documentación

iKreo REST API

Accede a tus proyectos, tareas y registros de tiempo desde cualquier aplicación externa. Disponible para todos los usuarios del plan Pro.

🔑 Autenticación

Incluye tu API key en el header de cada petición:

Authorization: Bearer sk_kreo_TU_API_KEY

Genera tu API key en Mi Perfil → API Key

⚠️ Nunca compartas tu API key públicamente. Trátala como una contraseña. Puedes regenerarla en cualquier momento desde tu perfil.

Base URL

https://ikreo.app/apidocs.php?endpoint={endpoint}

Endpoints disponibles

GET ?endpoint=me — Información del usuario autenticado

curl "https://ikreo.app/apidocs.php?endpoint=me" \
  -H "Authorization: Bearer sk_kreo_..."

{
  "ok": true,
  "user": { "id": 12, "name": "Ana Torres", "email": "ana@miempresa.com", "role": "admin", "company": "Mi Empresa S.A.", "plan": "pro" }
}

GET ?endpoint=users — Miembros activos de tu equipo

Devuelve los usuarios activos con su id y email. Úsalos como valor de assigned_to al crear tareas — sin necesidad de hardcodear IDs en tu script.

curl "https://ikreo.app/apidocs.php?endpoint=users" \
  -H "Authorization: Bearer sk_kreo_..."

{
  "ok": true,
  "total": 3,
  "data": [
    { "id": 1, "name": "Ana Torres",   "email": "ana@miempresa.com",    "role": "admin", "status": "active" },
    { "id": 2, "name": "Luis Herrera", "email": "luis@miempresa.com",   "role": "user",  "status": "active" },
    { "id": 3, "name": "Sara Muñoz",   "email": "sara@miempresa.com",   "role": "user",  "status": "active" }
  ]
}

GET ?endpoint=projects — Lista de proyectos de tu empresa

Parámetros opcionales: limit (máx 200, default 50) · offset

curl "https://ikreo.app/apidocs.php?endpoint=projects&limit=20" \
  -H "Authorization: Bearer sk_kreo_..."

GET ?endpoint=tasks — Tareas de tu empresa

Parámetros opcionales: project_id · status (todo/in_progress/done) · limit · offset

curl "https://ikreo.app/apidocs.php?endpoint=tasks&project_id=5&status=in_progress" \
  -H "Authorization: Bearer sk_kreo_..."

GET ?endpoint=time_logs — Registros de tiempo

Parámetros opcionales: task_id · date_from · date_to (formato YYYY-MM-DD)

curl "https://ikreo.app/apidocs.php?endpoint=time_logs&date_from=2026-06-01&date_to=2026-06-30" \
  -H "Authorization: Bearer sk_kreo_..."

POST ?endpoint=create_task — Crear una tarea y asignarla

Body JSON: title* · project_id* · assigned_to (email o ID) · description · status · priority · due_date

💡 assigned_to acepta el email del usuario (ana@miempresa.com) o su ID numérico (1). Usa GET ?endpoint=users para ver el listado de tu equipo. Si se omite, la tarea queda asignada al dueño de la API key.

curl -X POST "https://ikreo.app/apidocs.php?endpoint=create_task" \
  -H "Authorization: Bearer sk_kreo_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Revisar entrega del cliente",
    "project_id": 3,
    "description": "Validar los archivos enviados y dar feedback antes del viernes.",
    "status": "todo",
    "priority": "alta",
    "due_date": "2026-06-30",
    "assigned_to": "luis@miempresa.com"
  }'

Códigos de respuesta

200

401

No autenticado

403

Sin permisos

404

Endpoint no existe