API-Referenz
Erstellen Sie Integrationen mit Kanmans REST-API. Erstellen, lesen, aktualisieren und löschen Sie Ihre Daten programmgesteuert.
Die Kanman-API ermöglicht Ihnen programmgesteuerten Zugriff auf Ihre Boards, Projekte, Aufgaben und mehr. Erstellen Sie benutzerdefinierte Integrationen, automatisieren Sie Workflows, synchronisieren Sie mit anderen Tools oder schaffen Sie völlig neue Erlebnisse auf Basis Ihrer Kanman-Daten.
Ob Sie ein Reporting-Dashboard erstellen, eine Verbindung zu Ihrer CI/CD-Pipeline herstellen, mit Zapier integrieren oder eine eigene mobile App entwickeln – die API bietet alles, was Sie für die programmgesteuerte Arbeit mit Ihren Daten benötigen.
Pro-Funktion: API-Zugriff erfordert einen Pro- oder Teams-Tarif.
Übersicht
| Eigenschaft | Wert |
|---|---|
| Basis-URL | https://api.kanman.de/v1 |
| Protokoll | Nur HTTPS (TLS 1.2+) |
| Format | JSON für Anfrage- und Antwortkörper |
| Authentifizierung | Bearer-Token (API-Schlüssel) |
| Rate-Limiting | Basierend auf Tarifstufe |
Schnellstart
Starten Sie in Sekunden mit einem einfachen curl-Befehl:
# Alle Boards auflisten
curl https://api.kanman.de/v1/boards \
-H "Authorization: Bearer km_ihr_api_token"
Um einen API-Token zu erhalten, gehen Sie zu Einstellungen > API-Tokens in der Kanman-App.
API-Bereiche
Diese Dokumentation ist in folgende Bereiche unterteilt:
- Authentifizierung - Erfahren Sie, wie Sie API-Tokens erstellen und verwenden, verstehen Sie Berechtigungsbereiche und sichern Sie Ihre Integrationen
- Boards - Boards erstellen, lesen, aktualisieren und löschen
- Projekte - Projekte innerhalb von Boards verwalten
- Aufgaben - Mit Aufgaben und Unteraufgaben arbeiten
- Rate-Limits - Nutzungskontingente verstehen und innerhalb der Grenzen bleiben
- Fehler - Fehler elegant mit standardisierten Fehlerantworten behandeln
Rate-Limits
Die API-Nutzung ist je nach Tarif begrenzt:
| Tarif | API-Aufrufe/Monat | Anfragen/Sekunde |
|---|---|---|
| Pro | 12.000 | 10 |
| Teams | 60.000 | 30 |
Benötigen Sie mehr Kapazität? Zusatzpakete sind verfügbar. Kontaktieren Sie den Support für Details.
Häufige Anwendungsfälle
Die API unterstützt eine Vielzahl von Integrationen:
- Reporting & Analytics - Ziehen Sie Aufgabenabschlussdaten in Ihre Business-Intelligence-Tools
- CI/CD-Integration - Erstellen Sie automatisch Aufgaben, wenn Builds fehlschlagen oder Deployments abgeschlossen werden
- Formularübermittlungen - Erstellen Sie Aufgaben aus Webformularen, Kundenanfragen oder Support-Tickets
- Zwei-Wege-Synchronisation - Halten Sie Kanman mit anderen Projektmanagement-Tools synchron
- Benutzerdefinierte Dashboards - Erstellen Sie maßgeschneiderte Ansichten für Stakeholder oder Teams
- Automatisierung - Lösen Sie Aktionen basierend auf Aufgabenänderungen mithilfe von Webhooks und der API aus
Support
Für API-Support:
- E-Mail: [email protected]
- Statusseite: status.kanman.de für Echtzeit-API-Status
- Dokumentationsprobleme: Melden Sie Dokumentationsprobleme, um uns bei der Verbesserung zu helfen
Authentifizierung PRO
Erfahren Sie, wie Sie sich mit der Kanman API über API-Token authentifizieren.
Boards API PRO
API-Endpunkte zum Auflisten und Abrufen von Boards.
Projekte API PRO
API-Endpunkte zum Auflisten und Abrufen von Projekten und deren Aufgaben.
Aufgaben API PRO
API-Endpunkte zum Erstellen, Lesen, Aktualisieren und Löschen von Aufgaben.
Rate-Limits PRO
Verstehen Sie API-Rate-Limits und Kontingente für verschiedene Tarife.
Fehlerbehandlung PRO
Behandeln Sie API-Fehler elegant mit detaillierten Fehlercodes und Nachrichten.