Krokanti Tasks proporciona una API REST para construir automatizaciones e integraciones. El acceso se controla mediante tokens de API personales.

El acceso a la API requiere un plan Pro o Team. Las cuentas del plan gratuito no pueden generar tokens de API.

Crear un token de API

Ve a Ajustes -> Seguridad (haz clic en tu avatar en la esquina superior derecha, luego Ajustes)
Desplázate hasta la sección Tokens de API
Haz clic en Nuevo token
Dale un nombre al token (ej. "Zapier", "Script de automatización", "Plugin VS Code")
Copia el token inmediatamente — solo se muestra una vez

Formato del token: kt_ seguido de 40 caracteres hexadecimales.

Almacena tu token de forma segura. Krokanti Tasks solo almacena un hash de tu token, por lo que no puede recuperarse. Si lo pierdes, revócalo y genera uno nuevo.

Usar la API

Incluye tu token en la cabecera Authorization de cada petición:

Authorization: Bearer kt_tu_token_aqui

Ejemplo: Listar tus tareas

curl https://tasks.krokanti.com/api/tasks?projectId=PROJECT_ID \
  -H "Authorization: Bearer kt_tu_token_aqui"

Límites de tasa

Las peticiones a la API están limitadas a 100 peticiones por minuto por token. Si excedes este límite, recibirás una respuesta 429 Too Many Requests con una cabecera Retry-After.

Endpoints disponibles

La API REST cubre toda la jerarquía de gestión de tareas:

Recurso	Métodos	Descripción
`/api/spaces`	GET, POST	Listar y crear espacios
`/api/projects`	GET, POST	Listar y crear proyectos
`/api/tasks`	GET, POST	Listar y crear tareas
`/api/tasks/[id]`	GET, PATCH, DELETE	Leer, actualizar, eliminar tareas
`/api/tasks/[id]/assignees`	POST, DELETE	Gestionar asignados
`/api/tasks/[id]/labels`	POST, DELETE	Gestionar etiquetas

La documentación completa de la API está disponible en tasks.krokanti.com/developers.

Revocar tokens

Para revocar un token:

Ve a Ajustes -> Seguridad -> Tokens de API
Haz clic en Revocar junto al token
El token se invalida inmediatamente

Los tokens revocados no pueden recuperarse ni reactivarse. Genera un nuevo token si necesitas acceso continuado.

Buenas prácticas de seguridad

Usa un token por integración — facilita revocar uno sin afectar a otros
Usa nombres descriptivos — "Zapier Producción" es mejor que "Token 1"
Rota los tokens periódicamente — especialmente tras cambios en el equipo
Nunca incluyas tokens en control de versiones — usa variables de entorno

Tokens de API e integraciones