API de Planely
Opera tus proyectos desde fuera de la aplicación — integraciones, automatizaciones, scripts, crons — con una API HTTP JSON autenticada por API keys de proyecto con permisos configurables.
Qué es
Todo lo que haces en la pantalla de tareas de un proyecto también se puede hacer por HTTP: crear y actualizar tareas, ordenarlas con dependencias, adjuntar ficheros, comentar, gestionar etiquetas y sprints, rescatar lo que fue a la papelera, o consultar miembros para resolver asignaciones. La guía (esta sección y las siguientes) explica las reglas comunes; la referencia documenta cada endpoint con la misma estructura: método y ruta, permiso necesario, parámetros y un ejemplo de petición y respuesta.
URL base
Todas las rutas cuelgan de https://planely.dev/api/v1. Las peticiones y respuestas son JSON (Content-Type: application/json en los cuerpos que envíes).
curl https://planely.dev/api/v1/project \
-H "Authorization: Bearer $PLANELY_API_KEY"Una key, un proyecto
Cada API key pertenece a un único proyecto, así que el proyecto va implícito en la key y nunca aparece en la ruta. Para operar varios proyectos, crea una key por proyecto. Si una key se filtra, su alcance máximo es ese proyecto — nunca tu cuenta entera.
Efectos en la app
Los cambios hechos por la API son ciudadanos de primera en el producto: se difunden en tiempo real a los miembros que tengan el proyecto abierto, quedan en el historial de cada tarea con el nombre de la key como autor (p. ej. «mi-integración (API)») y disparan las mismas notificaciones que la app — asignar una tarea por API notifica al asignado.