Per sviluppatori

Costruisci su Onplana

Leggi e modifica progetti e attività dal tuo codice, scopri le modifiche appena avvengono, porta il piano nei tuoi report e lascia che gli agenti IA ci lavorino. Cinque vie d’accesso, ognuna con un token che agisce come la persona che l’ha creato.

Cinque vie d’accesso

Funzionano tutte già oggi. Parti dall’esempio e poi segui la sua guida.

API REST con token di accesso personali

Crea un token in Impostazioni, poi Sviluppatore, solo con i permessi e i progetti che ti servono e con una data di scadenza. Agisce come te, in una sola organizzazione, e non può mai fare più di quanto puoi fare tu. La specifica OpenAPI 3.1 descrive ogni percorso.

Tutti i piani, incluso quello gratuito

Le tue attività aperte, in tutti i progetti
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Webhook firmati

Onplana invia con POST un payload JSON al tuo URL quando si verifica uno dei 22 tipi di evento. Ogni consegna porta una firma HMAC-SHA256 del corpo, fatta con il tuo segreto, e ogni tentativo resta nello storico delle consegne.

Dal piano Business

Sapere quando un’attività cambia stato
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"}'

Il feed di report OData

Un feed OData v4 in sola lettura con progetti, attività, assegnazioni, risorse, righe dei fogli ore, valori dei campi personalizzati e baseline. Power BI, Excel o il tuo data warehouse accedono con un token che ha il permesso dei report.

Dal piano Professional

Leggere cinque attività dal feed
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

Server MCP per agenti IA

Claude, ChatGPT, Cursor e qualsiasi altro client MCP possono leggere e gestire il lavoro con i permessi della persona che li collega. I client accedono nel browser, quindi non c’è nessuna app da registrare prima.

Tutti i piani, incluso quello gratuito. Il numero di agenti collegati contemporaneamente cresce con il piano.

Aggiungere Onplana a un client MCP
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

Connettori

Prima di costruire, verifica se il collegamento esiste già. Ogni connettore accede con un token di accesso personale ed esegue per prima la stessa verifica.

  • Microsoft Teams e Microsoft 365 Copilot: disponibili, in tutti i piani, incluso quello gratuito.
  • Link a file di SharePoint e OneDrive nelle attività: disponibili, dal piano Professional.
  • Power Automate e Power Apps: il connettore è costruito sulla stessa API e non è ancora pubblicato.
  • Zapier: l’app è costruita sulla stessa API e non è ancora pubblicata.

I trigger di un connettore sottoscrivono un webhook: Dal piano Business.

La verifica del collegamento di un connettore
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Come funziona una richiesta

  • Invia il token come token Bearer. Un token è legato all’organizzazione in cui è stato creato, quindi una richiesta non ha bisogno di un’intestazione di organizzazione.
  • Gli errori tornano come JSON con una frase che puoi mostrare, un codice e un requestId da citare quando scrivi all’assistenza.
  • I limiti sono fissati per famiglia di percorsi. Una richiesta rifiutata risponde 429 con un’intestazione Retry-After in secondi: aspetta quel tempo e riprova.
  • La specifica è su api.onplana.com/api/openapi.json, quindi puoi generare un client in qualsiasi linguaggio a partire da essa.

Quale piano serve per ogni via

Letto dalla tabella dei prezzi, così questo elenco e la pagina dei prezzi coincidono sempre.

Cosa usaPiano
API REST e token di accesso personaliTutti i piani, incluso quello gratuito
WebhookDal piano Business
Feed di report ODataDal piano Professional
Server MCPTutti i piani, incluso quello gratuito
App per Microsoft Teams e agente CopilotTutti i piani, incluso quello gratuito
Link a file di SharePoint e OneDriveDal piano Professional
Trigger dei connettori (sottoscrivono un webhook)Dal piano Business

Cosa chiedono gli sviluppatori

Esiste un SDK?

No. L’API è JSON su HTTPS con una specifica OpenAPI 3.1, quindi va bene qualsiasi client HTTP, e puoi generare un client tipizzato dalla specifica.

L’API si paga a parte?

No. L’API REST e i token sono disponibili in tutti i piani, incluso quello gratuito. I webhook sono disponibili dal piano Business e il feed OData dal piano Professional.

La mia applicazione server può agire per conto di molti clienti?

Non ancora tramite OAuth. Oggi ogni cliente crea un token per la sua integrazione, e il token agisce come la persona che l’ha creato. Se il tuo prodotto ha bisogno di altro, raccontaci di cosa si tratta.

Dove sono le condizioni d’uso dell’API?

La pagina delle condizioni dell’API, nella documentazione per sviluppatori, spiega l’uso accettabile, cosa rappresenta un token e come vengono annunciate le modifiche incompatibili.

Crea il tuo primo token

Registrati gratis, apri Impostazioni, poi Sviluppatore, e crea un token con i permessi che servono al tuo codice.