Para desarrolladores

Construya sobre Onplana

Lea y cambie proyectos y tareas desde su propio código, entérese de los cambios en cuanto ocurren, lleve el plan a sus informes y deje que los agentes de IA trabajen en él. Cinco vías de entrada, cada una con un token que actúa como la persona que lo creó.

Cinco vías de entrada

Todas funcionan hoy. Empiece por el ejemplo y siga después su guía.

API REST con tokens de acceso personal

Cree un token en Configuración, luego Desarrollador, solo con los permisos y proyectos que necesita y con una fecha de caducidad. Actúa como usted, en una organización, y nunca puede hacer más que usted. La especificación OpenAPI 3.1 describe cada ruta.

Todos los planes, incluido el gratuito

Sus tareas abiertas, en todos los proyectos
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Webhooks firmados

Onplana envía por POST una carga JSON a su URL cuando ocurre uno de 22 tipos de evento. Cada entrega lleva una firma HMAC-SHA256 del cuerpo, hecha con su secreto, y cada intento queda en el historial de entregas.

Desde el plan Business

Saber cuándo una tarea cambia de estado
curl -X POST https://api.onplana.com/api/webhooks \
  -H "Authorization: Bearer pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Status changes","url":"https://example.com/onplana","events":["task.status_changed"],"secret":"YOUR_SECRET"}'

El feed de informes OData

Un feed OData v4 de solo lectura con proyectos, tareas, asignaciones, recursos, líneas de partes de horas, valores de campos personalizados y líneas base. Power BI, Excel o su almacén de datos inicia sesión con un token que tiene el permiso de informes.

Desde el plan Professional

Leer cinco tareas del feed
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

Servidor MCP para agentes de IA

Claude, ChatGPT, Cursor y cualquier otro cliente MCP pueden leer y gestionar el trabajo con los permisos de la persona que los conecta. Los clientes inician sesión en el navegador, así que no hay que registrar ninguna aplicación antes.

Todos los planes, incluido el gratuito. El número de agentes conectados a la vez crece con el plan.

Añadir Onplana a un cliente MCP
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

Conectores

Antes de construir, compruebe si la conexión ya existe. Cada conector inicia sesión con un token de acceso personal y ejecuta primero la misma comprobación.

  • Microsoft Teams y Microsoft 365 Copilot: disponibles, en todos los planes, incluido el gratuito.
  • Vínculos a archivos de SharePoint y OneDrive en las tareas: disponibles, desde el plan Professional.
  • Power Automate y Power Apps: el conector está construido sobre la misma API y todavía no está publicado.
  • Zapier: la aplicación está construida sobre la misma API y todavía no está publicada.

Los desencadenadores de un conector suscriben un webhook: Desde el plan Business.

La comprobación de conexión de un conector
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Cómo funciona una solicitud

  • Envíe el token como token Bearer. Un token está ligado a la organización en la que se creó, así que una solicitud no necesita cabecera de organización.
  • Los errores vuelven como JSON con una frase que puede mostrar, un código y un requestId para citar cuando escriba a soporte.
  • Los límites se fijan por familia de rutas. Una solicitud rechazada responde 429 con una cabecera Retry-After en segundos: espere ese tiempo y vuelva a intentarlo.
  • La especificación está en api.onplana.com/api/openapi.json, así que puede generar un cliente en cualquier lenguaje a partir de ella.

Qué plan necesita cada vía

Leído de la tabla de precios, para que esta lista y la página de precios coincidan siempre.

Lo que usaPlan
API REST y tokens de acceso personalTodos los planes, incluido el gratuito
WebhooksDesde el plan Business
Feed de informes ODataDesde el plan Professional
Servidor MCPTodos los planes, incluido el gratuito
Aplicación de Microsoft Teams y agente de CopilotTodos los planes, incluido el gratuito
Vínculos a archivos de SharePoint y OneDriveDesde el plan Professional
Desencadenadores de conectores (suscriben un webhook)Desde el plan Business

Lo que preguntan los desarrolladores

¿Hay un SDK?

No. La API es JSON sobre HTTPS con una especificación OpenAPI 3.1, así que sirve cualquier cliente HTTP, y puede generar un cliente tipado a partir de la especificación.

¿La API cuesta aparte?

No. La API REST y los tokens están en todos los planes, incluido el gratuito. Los webhooks están desde el plan Business y el feed OData desde el plan Professional.

¿Puede mi aplicación de servidor actuar para muchos clientes?

Todavía no mediante OAuth. Hoy cada cliente crea un token para su integración, y el token actúa como la persona que lo creó. Si su producto necesita más, cuéntenos qué es.

¿Dónde están las condiciones de uso de la API?

La página de condiciones de la API, en la documentación para desarrolladores, explica el uso aceptable, lo que representa un token y cómo se anuncian los cambios incompatibles.

Cree su primer token

Regístrese gratis, abra Configuración, luego Desarrollador, y cree un token con los permisos que necesita su código.