API v1 disponible

Plataforma para desarrolladores ProjectOps360

Conecta las operaciones de tus proyectos.

Usa un solo contrato versionado para leer la verdad del proyecto, crear trabajo gobernado, recibir eventos firmados, conectar agentes de IA mediante MCP y automatizar desde la línea de comandos.

Inicio rápido

Autenticación

Crea una cuenta de servicio y un token con scopes dentro de ProjectOps360; luego llama la API pública usando un token Bearer.

Envía el token en el encabezado Authorization. Los tokens comienzan con p360_ y se muestran una sola vez. Nunca los coloques en código del navegador ni en el repositorio.

URL base

https://projectops360.com/api/v1

Authorization

Bearer p360_••••••••••••••••

Recursos de la API

Las lecturas son paginadas y limitadas a la organización. Las escrituras delegan en comandos canónicos y conservan la procedencia de auditoría.

RecursoLecturaCreación
/projectsProyectosSí—
/milestonesHitosSíSí
/tasksTareasSíSí
/subtasksSubtareasSíSí
/dependenciesDependenciasSí—
/risksRiesgosSí—
/issuesIncidenciasSí—
/peoplePersonasSí—
/time-entriesRegistros de tiempoSí—
/eventsEventosSí—

Ejemplos de solicitudes

Listar proyectos

curl "https://projectops360.com/api/v1/projects?limit=10" \
  -H "Authorization: Bearer $PROJECTOPS360_TOKEN"

Crear una tarea

curl -X POST "https://projectops360.com/api/v1/tasks" \
  -H "Authorization: Bearer $PROJECTOPS360_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_UUID","title":"Integration task","priority":"p2"}'

Scopes

Concede únicamente los scopes que necesita la integración. Los propietarios y administradores pueden revocar el token inmediatamente.

projects:readmilestones:readmilestones:writetasks:readtasks:writesubtasks:readsubtasks:writedependencies:readrisks:readissues:readpeople:readtime_entries:readevents:readwebhooks:managemcp:use
/api/v1/webhooks

Webhooks firmados

Suscríbete a eventos canónicos del proyecto. Las entregas usan POST, incluyen un identificador único, reintentan errores transitorios y firman el cuerpo exacto.

Verifica x-projectops-signature con el secreto del webhook y rechaza valores antiguos de x-projectops-timestamp. Usa x-projectops-delivery como clave de idempotencia.

/api/v1/mcp

Servidor MCP

Conecta agentes de IA compatibles al mismo vocabulario gobernado. El endpoint MCP acepta JSON-RPC mediante POST; abrirlo directamente en el navegador no es una prueba válida.

initialize · tools/list · tools/call

cli/projectops360.mjs

Línea de comandos

El CLI sin dependencias permite listar, consultar, crear e importar tareas secuencialmente.

p360 list · get · create · import

Sandbox para desarrolladores

El sandbox autenticado mantiene el token solamente en el formulario, permite seleccionar un recurso y ejecuta lecturas reales de /api/v1.

Abrir ajustes de desarrolladores

Modelo de seguridad

Cada token pertenece a una organización y una cuenta de servicio. Se mantienen RBAC, RLS, scopes explícitos, auditoría, hash de tokens, firmas, reintentos y procedencia canónica.