Für Entwickler

Auf Onplana aufbauen

Lesen und ändern Sie Projekte und Aufgaben aus Ihrem eigenen Code, erfahren Sie sofort von Änderungen, holen Sie den Plan in Ihre Berichte und lassen Sie KI-Agenten darin arbeiten. Fünf Zugänge, jeder mit einem Token, das als die Person handelt, die es erstellt hat.

Fünf Zugänge

Jeder funktioniert schon heute. Beginnen Sie mit dem Beispiel und folgen Sie dann der Anleitung.

REST-API mit persönlichen Zugriffstoken

Erstellen Sie unter Einstellungen, dann Entwickler, ein Token mit genau den Berechtigungen und Projekten, die es braucht, und mit einem Ablaufdatum. Es handelt als Sie, in einer Organisation, und kann nie mehr als Sie. Die OpenAPI-3.1-Spezifikation beschreibt jede Route.

Jeder Tarif, auch der kostenlose

Ihre offenen Aufgaben, über alle Projekte
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Signierte Webhooks

Onplana sendet per POST eine JSON-Nutzlast an Ihre URL, sobald eines von 22 Ereignissen eintritt. Jede Zustellung trägt eine HMAC-SHA256-Signatur des Inhalts, gebildet mit Ihrem Geheimnis, und jeder Versuch bleibt im Zustellverlauf erhalten.

Ab dem Tarif Business

Erfahren, wenn eine Aufgabe ihren Status ändert
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"}'

Der OData-Berichtsfeed

Ein schreibgeschützter OData-v4-Feed mit Projekten, Aufgaben, Zuweisungen, Ressourcen, Zeiterfassungszeilen, Werten benutzerdefinierter Felder und Basisplänen. Power BI, Excel oder Ihr Data Warehouse meldet sich mit einem Token an, das die Berechtigung für Berichte hat.

Ab dem Tarif Professional

Fünf Aufgaben aus dem Feed lesen
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

MCP-Server für KI-Agenten

Claude, ChatGPT, Cursor und jeder andere MCP-Client kann Arbeit lesen und verwalten, mit den Rechten der Person, die ihn verbindet. Clients melden sich über den Browser an, Sie müssen also vorher keine App registrieren.

Jeder Tarif, auch der kostenlose. Wie viele Agenten gleichzeitig verbunden sein können, wächst mit dem Tarif.

Onplana zu einem MCP-Client hinzufügen
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

Konnektoren

Prüfen Sie vor dem Bauen, ob die Verbindung schon besteht. Jeder Konnektor meldet sich mit einem persönlichen Zugriffstoken an und führt zuerst dieselbe Prüfung aus.

  • Microsoft Teams und Microsoft 365 Copilot: verfügbar, in jedem Tarif, auch im kostenlosen.
  • Dateilinks aus SharePoint und OneDrive an Aufgaben: verfügbar, ab dem Tarif Professional.
  • Power Automate und Power Apps: Der Konnektor ist auf derselben API gebaut und noch nicht gelistet.
  • Zapier: Die App ist auf derselben API gebaut und noch nicht gelistet.

Trigger eines Konnektors abonnieren einen Webhook: Ab dem Tarif Business.

Die Verbindungsprüfung eines Konnektors
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

So funktioniert eine Anfrage

  • Senden Sie das Token als Bearer-Token. Ein Token ist an die Organisation gebunden, in der es erstellt wurde, eine Anfrage braucht also keinen Organisations-Header.
  • Fehler kommen als JSON zurück, mit einem Satz, den Sie anzeigen dürfen, einem Code und einer requestId, die Sie dem Support nennen.
  • Grenzen gelten je Routengruppe. Eine abgelehnte Anfrage antwortet mit 429 und einem Retry-After-Header in Sekunden: Warten Sie so lange und versuchen Sie es dann erneut.
  • Die Spezifikation liegt unter api.onplana.com/api/openapi.json, daraus können Sie in jeder Sprache einen Client erzeugen.

Welcher Tarif für welchen Zugang

Aus der Preistabelle gelesen, damit diese Liste und die Preisseite immer übereinstimmen.

Was Sie nutzenTarif
REST-API und persönliche ZugriffstokenJeder Tarif, auch der kostenlose
WebhooksAb dem Tarif Business
OData-BerichtsfeedAb dem Tarif Professional
MCP-ServerJeder Tarif, auch der kostenlose
Microsoft-Teams-App und Copilot-AgentJeder Tarif, auch der kostenlose
Dateilinks aus SharePoint und OneDriveAb dem Tarif Professional
Trigger von Konnektoren (sie abonnieren einen Webhook)Ab dem Tarif Business

Was Entwickler fragen

Gibt es ein SDK?

Nein. Die API ist reines JSON über HTTPS mit einer OpenAPI-3.1-Spezifikation, jeder HTTP-Client funktioniert also, und Sie können aus der Spezifikation einen typisierten Client erzeugen.

Kostet die API extra?

Nein. Die REST-API und die Token gibt es in jedem Tarif, auch im kostenlosen. Webhooks gibt es ab dem Tarif Business, den OData-Feed ab dem Tarif Professional.

Kann meine Serveranwendung für viele Kunden handeln?

Über OAuth noch nicht. Heute erstellt jeder Kunde ein Token für Ihre Integration, und das Token handelt als die Person, die es erstellt hat. Wenn Ihr Produkt mehr braucht, sagen Sie uns, was es ist.

Wo stehen die Bedingungen für die Nutzung der API?

Die Seite mit den API-Bedingungen in der Entwicklerdokumentation beschreibt die zulässige Nutzung, wofür ein Token steht und wie inkompatible Änderungen angekündigt werden.

Erstellen Sie Ihr erstes Token

Registrieren Sie sich kostenlos, öffnen Sie Einstellungen, dann Entwickler, und erstellen Sie ein Token mit den Berechtigungen, die Ihr Code braucht.