API

Finden Sie heraus, wie Sie die Kanbanize Restful API nutzen können.

Allgemeine Informationen


Um die Kanbanize API zu nutzen, müssen Sie eine https POST-Anfrage an die folgende Adresse senden:

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/<function>

 

Wo:

<subdomain> ist der Subdomain-Teil für Ihren Account.

<function> ist eine der Folgenden:

 

Es existieren Folgende Limits zur API-Nutzung:

Funktion login get_projects_and_boards get_board_structure get_board_settings create_new_task delete_task get_task_details
Limit pro Stunde (pro API KEY) 30 30 30 30 30 60 60
Funktion get_all_tasks add_comment move_task edit_task get_board_activities block_task
Limit pro Stunde (pro API KEY) 60 30 60 30 30 30

Authentifizierung


Jeder Kanbanize Nutzer hat einen persönlichen API-Schlüssel, der zur Autentifizierung des Benutzers beim Zugriff auf die API verwendet wird. Jede API-Anfrage (außer dieser für die „login“-Funktion) muss einen gültigen http-Header mit dem Namen “apikey” beinhalten. Der Header-Wert soll ein gültiger API-Schlüssel sein. Sie können ihn in dem Output der „Anmelden“-Funktion oder über die Web-Version (klicken Sie auf Ihren Benutzernamen in der oberen rechten Ecke und wählen Sie API) erhalten.

Wenn Sie eine Zwei-Faktor-Authentifizierung (2FA) für Ihren Account aktiviert haben, müssen Sie einen zusätzlichen Header mit dem Namen „otp“ übermitteln. Dieser Header soll ein gültiges One-time Password (OTP) für die Zeit, in der die Anfrage erstellt wird, enthalten. Der Algorithmus zur Erzeugung von One-time Password basiert auf der Implementierung von Google Authenticator. Der persönliche 2FA-Geheimschlüssel verwendet in dem Algorithmus wird nur einmal angezeit, wenn die 2FA erzeugt wird. Sie sollten ihn an einem sicheren Ort aufbewahren und ihn verwenden, um wenn notwendig OTPs zu erzeugen. Weitere Informationen erhalten Sie in diesem Artikel auf unserem Blog.

 

 

Input Parameter


Je nach der Funktion, auf die Sie zugreifen, müssen Sie bestimmte Parameter angeben, damit die Anfrage korrekt bearbeitet werden kann. Die Parameter werden entweder im Anfrage-URI oder im Anfrage-Body der Anfrage festgelegt. Der Anfrage-Body ist die empfohlene Vorgehensweise.

 

Beispiele:

 

Parameter senden “boardid” mit Wert 22 als Teil des Anfgare-URIs:

 

https://<subdomain>/index.php/api/kanbanize/<function>/boardid/22

 

Parameter senden “boardid” mit Wert 22 und Parameter “taskid” mit Wert 14 als Teil des Anfrage-URIs:

 

https://<subdomain>/index.php/api/kanbanize/<function>/boardid/22/taskid/14

 

Parameter senden “boardid” mit Wert 22 und Parameter “taskid” mit Wert 14 als Teil des Anfrage-BODYs. Der BODY muss eine gültige JSON-Zeichenfolge sein. Wenn ein Wert sowohl in dem BODY wie auch in dem URI festgelegt wird, wird der BODY-Wert genommen. Wenn Sie einen Backslash (\) oder Anführungszeichen (“) verwenden, muss ein Backslash als Markierungszeichenzeichen vorangestellt werden: (\\) or (\”).

 

The request URI: https://<subdomain>/index.php/api/kanbanize/<function>

The request body: {"boardid":22,"taskid":14}

 

Sie können auch das Ergebnisformat angeben. Mögliche Formate sind:

 

XML (Default, wenn Formatierungsparameter nicht angegeben)

 

https://<subdomain>/index.php/api/kanbanize/<function>/<parameters>/format/xml

 

JSON (Weitere Informationen erhalten Sie auf dieser Website http://www.json.org/)

 

https://<subdomain>/index.php/api/kanbanize/<function>/<parameters>/format/json

API Anmeldung [login]


Benötigt email pass
Ihre E-mail-Adresse Ihr Passwort
Optional n/a
Output mail username realname companyname timezone apikey
Ihre E-mail-Adresse Ihr Benutzername Ihr Name Name des Unternehmen hre Zeitzone Ihr API-Schlüssel.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/login/
Body beantragen: {"email": "test@test.com", "pass":"test"}

 

Projekte und Boards [get_projects_and_boards]


Benötigt n/a
Optional n/a
Output projects projects[][name] projects[][id] projects[][boards]
Array der Projekte. Name des Projekts. Projekt-ID Array der Details für alle Boards des aktuellen Projekts (Name, ID)

 

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_projects_and_boards/

Board Struktur [get_board_structure]


Benötigt boardid
Die ID des Boards, dessen Struktur Sie erhalten möchten. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen.
Optional n/a
Output columns columns[][position] columns[][lcname] columns[][description] lanes lanes[][lcname] lanes[][color] lanes[][description]
Array der Board-Spalten (nur die Spalten auf der letzten Ebene werden zurückgegeben) Die Position der Spalte Der Name der Spalte Die Beschreibung der Spalte oder der Swimlane. Array der Board-Swimlanes. Der Name der Swimlane. Die Farbe der Swimlane. Die Beschreibung der Spalte oder der Swimlane.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_structure/
Body beantragen: {"boardid":"2"}

Vollstandige Board Struktur [get_full_board_structure]


Benötigt boardid
Die ID des Boards, dessen Struktur Sie erhalten möchten. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen.
Optional n/a
Output columns columns[][position] columns[][lcname] columns[][path] columns[][description] columns[][lcid] columns[][children[]]* lanes lanes[][position] lanes[][lcname] lanes[][path] lanes[][color] lanes[][description] lanes[][lcid]
Array der Board-Spalten Die Position der Spalte Der Name der Spalte. Eindeutige Kennung, die die ID der Spalte mit allen übergeordneten Spalten enthält. Z.B. progress_17_1478 bedeutet, dass die Spalten-ID 1478 ist, das übergeordnete Element ist die Spalte mit ID 17 und der übergeordnete Bereich ist IN BEARBEITUNG. Die Beschreibung der Spalte oder der Swimlane. Lane- / Spalten-ID Dies ist die ID der Spalte, die der letzte Teil des oben beschriebenen Pfadparameters ist. Wenn die Spalte Unterspalten enthält, werden sie rekursiv im Kinder-Array zurückgegeben. Array der Board-Swimlanes. Die Position der Swimlane. Der Name der Swimlane. Eindeutige Kennung der Swimlane, die die mit der Swimlane- ID verknüpfte Zeichenfolge „lane_“ verkettet. Die Farbe der Swimlane. Die Beschreibung der Spalte oder der Swimlane. Lane- / Spalten-ID Dies ist die ID der Swimlane, die der letzte Teil des oben beschriebenen Pfadparameters ist.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_full_board_structure/
Body beantragen: {"boardid":"2"}

Boardeinstellungen [get_board_settings]


Benötigt boardid
Die ID des Boards, dessen Struktur Sie erhalten möchten. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen.
Optional n/a

Array mit den Definitionen aller benutzerdefinierten Felder, die dem Board zugewiesen sind.

Output usernames avatars templates types customFields
Array mit den Benutzernamen der Board-Mitglieder. Assoziatives Array, das die URLs zu den Avataren der Board-Mitglieder enthält. Array mit den für dieses Board verfügbaren Vorlagen. Array mit den für dieses Board verfügbaren Typen. Array mit den Definitionen aller benutzerdefinierten Felder, die des Boards zugewiesen sind.

 

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_settings/
Body beantragen: {"boardid":"2"}

Board Aktivitaten Holen [get_board_activities]


Benötigt boardid fromdate todate
Die ID des Boards. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Das Datum, nach dem die Aktivitäten in Frage passiert sind. Akzeptiert die folgenden Formate: ‚2012-05-05′, ’10. September 2012‘. Das Datum, vor dem die Aktivitäten in Frage passiert sind. Akzeptiert die folgenden Formate: ‚2012-05-05′, ’10. September 2012‘.
Optional page resultsperpage author eventtype textformat
Standard ist 1 Standard ist 30 Standard ist ALLE Optionen: Übergänge, Updates, Kommentare, Blöcke. Standard ist Alle Optionen: "plain" (Standard) und "html". Wenn das Nur-Text-Format verwendet wird, werden die HTML-Tags aus den Verlaufsdetails entfernt.
Output allactivities page activities activities[][author] activities[][event] activities[][text] activities[][date] activities[][taskid]
Die Anzahl aller Aktivitäten für das entsprechende Zeitfenster, die durch die Parameter vondatum und bisdatum angegeben werden. Die aktuelle Seite. Array mit den Boardaktivitäten. Wer hat die Aktion ausgeführt? Art des Ereignisses (Aufgabe verschoben, Aufgabe blockiert, Aufgabe archiviert usw.) Verlaufsdetails. Wann das Ereignis passiert ist. Die ID der Aufgabe, die aktualisiert / verschoben / blockiert wurde, usw.

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_activities/
Body beantragen: {"boardid":"2", "fromdate":"2012-08-05", "todate":"2017-08-05", "page":"2"}

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_board_activities/
Body beantragen: {"boardid":"2", "fromdate":"2012-08-05", "todate":"2017-08-05", "page":"3", "eventtype":"Comments"}

Neue Aufgabe Erstellen [create_new_task]


Wenn der durch den API-Schlüssel identifizierte Benutzer eine vordefinierte Standardspalte oder Swimlane für den angegebenen Board hat und in der Anfrage kein Parameter 'Spalte' oder 'Lane' angegeben ist, wird die Aufgabe in der Spalte oder Swimlane, die in den Board-Einstellungen hinterlegt wurde, erstellt.

 

Wenn für den angegebenen Board keine Standardspalte oder Swimlane konfiguriert ist und in der Anforderung keine 'Spalten-' oder 'Lane'-Parameter angegeben sind, wird die Aufgabe in der ersten Swimlane des Backlog-Bereichs des Boards erstellt.

 

Wenn die Parameter 'Spalte', 'Lane' und / oder 'Position' angegeben werden, wird nach dem Erstellen der Aufgabe automatisch ein Verschiebevorgang ausgeführt. Die Parameter 'Spalte' und 'Lane' überschreiben effektiv alle Konfigurationen in Bezug darauf, wo die Aufgabe erstellt werden soll.

 

 

Benötigt boardid
Die ID des Boards. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen.
Optional title description priority assignee color size tags deadline extlink type template < customfield > subtasks subtasks[][title] subtasks[][assignee] column lane position exceedingreason returntaskdetails
Überschrift der Aufgabe Beschreibung der Aufgabe Einer der folgenden Werte: Niedrig, Mittel, Hoch Benutzername des Beauftragten (muss ein gültiger Benutzername sein) Jeder beliebige Farbcode (z. B. # 34a97b) ohne das Zeichen #. Größe der Aufgabe Durch Leerzeichen getrennte Liste von Tags Frist im Format: JJJJ-MM-TT (z. B. 2011-12-13) Ein Link im folgenden Format: https://domain.com/resource. Diese Option wird nur unterstützt, wenn Parameter im Anfragetext gesendet werden. Der Name des Typs, den Sie festlegen möchten. Der Name der Vorlage, die Sie anwenden möchten. Wenn Sie eine Eigenschaft als Teil der Anfrage angeben, wird die in der Vorlage angegebene Eigenschaft überschrieben. Der Name des benutzerdefinierten Felds, das Sie festlegen möchten. Ein Array von Teilaufgaben. Überschrift der neuen Teilaufgabe. Ein Beauftragter für die Teilaufgabe (Standard: Keiner). Der Name der Spalte, in der die Aufgabe erstellt werden soll (Standard ist Backlog). Wenn Spaltennamen nicht einzigartig sind, müssen Sie den vollständigen Pfad zur Spalte angeben Der Name der Swimlane, in den die neu erstellte Aufgabe eingefügt werden soll. Wenn nicht angegeben, wird die Aufgabe in der ersten Schwimlane platziert. Die Position der Aufgabe in der neuen Spalte / Swimlane (nullbasiert). Wenn sie weggelassen wird, wird die Aufgabe am Ende der Spalte platziert. Wenn Sie ein Limit aus einem Grund überschreiten können, geben Sie diesen Parameter ein. Nur anwendbar, wenn Spalte, Spur und / oder Position geliefert werden. Wenn der Wert 1 ist, gibt die Methode die Details der erstellten Aufgabe zurück.
Output id details movingerror
Die ID der neu erstellten Aufgabe. Die Details der neu erstellten Aufgabe. (Nur wenn returntaskdetails festgelegt wurde)
Das Format entspricht der Ausgabe von aufgabendetails_aufrufen.
Wenn das Verschieben fehlgeschlagen ist, wird der Bewegungsfehler hier zurückgegeben. (Nur wenn Spalte, Swimlane und / oder Position festgelegt wurden)

 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/create_new_task/
Body beantragen: {"boardid":"17", "title":"test task", "description":"task description", "priority":"High", "assignee":"mitaka", "color":"FFCC00", "tags":"tag1 tag2", "deadline":"2011-12-13"}

Aufgabe Loschen [delete_task]


Benötigt boardid taskid
Die ID des Boards, auf dem sich die zu löschende Aufgabe befindet. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der zu löschenden Aufgabe.
Optional n/a
Output status
Der Status der Operation (1 oder Fehler).

 

http://<subdomain>.kanbanize.com/index.php/api/kanbanize/delete_task/
Body beantragen: {"boardid":"17", "taskid":"173"}

Aufgabendetails Holen [get_task_details]


 

Benötigt boardid taskid/taskid[]
  Die ID des Boards, auf dem sich die Aufgabe befindet. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der Aufgabe (oder ein Array von Aufgaben-IDs), deren Details Sie abrufen möchten.
Optional history comments event textformat
  Wählen Sie „Ja“, wenn Sie die Historie für die Aufgabe erhalten möchten. Wählen Sie „Ja“, wenn Sie Kommentare für die Aufgabe erhalten möchten. Nur anwendbar, wenn „historie“ auf „ja“ gesetzt ist. Akzeptiert die folgenden Ereignisse: Verschieben, Erstellen, Aktualisieren, Blockieren, Löschen, Kommentieren, Archivieren, Teilaufgabe, Protokollierte Zeit. Wenn der Parameter nicht festgelegt ist, werden alle Ereignisse zurückgegeben. Optionen: „plain“ (Standard) und „html“. Wenn das Nur-Text-Format verwendet wird, werden die HTML-Tags aus der Aufgabenbeschreibung entfernt.
Output taskid title description type assignee subtasks subtaskscomplete color priority size deadline deadlineoriginalformat extlink tags leadtime blocked blockedreason subtaskdetails comments historydetails columnname lanename columnid laneid position columnpath loggedtime customfields customfields[][fieldid] customfields[][name] customfields[][type] customfields[][value] customfields[][mandatory] attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status]
  Die Aufgaben-ID Die Überschrift der Aufgabe Die Bescheibung der Aufgabe Der Typ der Aufgabe Benutzername des Beauftragten Anzahl der Teilaufgaben Anzahl der abgeschlossenen Teilaufgaben Farbe der Aufgabe Priorität der Aufgabe Größe der Aufgabe Aufgabenstermin im Format Tag Monat (z. B. 01. August) Aufgabentermin im Format JJJJ-MM-TT (z. B. 2012-08-01) Aufgabenstermin im Format yyyy-mm-dd (e.g. 2012-08-01) Externer Link zur Aufgabe Aufgaben-Tags Vorlaufzeit in Tagen Ist die Aufgabe blockiert (0 – nein / 1 – ja) Wieso ist die Aufgabe blockiert? Details zu allen Teilaufgaben (Teilaufgaben-ID, Teilaufgabenbeauftragter, Teilaufgabenüberschrift, Teilaufgaben-Abschlussdatum). Details eines Kommentars (Autor, Ereignis, Text, Datum, Aufgaben-ID, Kommentar-ID). Details der Aufgabenhistorie (Ereignistyp, Verlaufsereignis, Details, Autor, Datum, Verlaufs-ID). Der Name der Spalte, in der sich die Aufgabe befindet. Der Name der Swimlane, in der sich die Aufgabe befindet. Die ID der Spalte, in der sich die Aufgabe befindet. Der Name der Swimlane, in der sich die Aufgabe befindet. Die Position der Karte in ihrer aktuellen Spalte. Der vollständige Pfad zur Kartenspalte im Format: „Spalte.Unterspalte1.Unterspalte2“. Wenn sich die Aufgabe in einer Hauptspalte befindet, entspricht dies „Spaltenname“. Die akkumulierte protokollierte Zeit der Aufgabe in Stunden. Array der benutzerdefinierten Felder, die auf die Karte angewendet wurden. Die ID-Nummer des Feldes. Der vollständige Pfad zur Kartenspalte im Format: „Spalte.Unterspalte1.Unterspalte2“. Wenn sich die Aufgabe in einer Hauptspalte befindet, entspricht dies „Spaltenname“. Datentyp des benutzerdefinierten Felds {Text | Datum | Nummer | Beitragender | Link | Dropdown}. Der Wert des benutzerdefinierten Felds. Ein Flag, wenn das Feld obligatorisch ist {wahr | falsch}. Array mit den Informationen über die neuen Dateien, die an die Karte angehängt sind. Eine Verknüpfung zu der Datei, wenn sie von einem Speicherdienst hinzugefügt wurde (Dropbox, Google Drive usw.). Der Name der Datei, die vom Benutzer hochgeladen wurde. Spezifischer Name der Datei. Die Größe der Datei. Die Erweiterung der Datei. Upload-Status.
 

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_task_details/
Body beantragen: {"boardid":"17", "taskid":"173"}

Alle Aufgaben Holen [get_all_tasks]


Benötigt boardid
Die ID des Boards, auf dem sich die Aufgaben befinden. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen.
Optional subtasks comments container fromdate todate showInitiatives version page textformat
Setzen Sie diese Option auf "Ja", wenn Sie für jede Aufgabe Unteraufgabeninformationen erhalten möchten. Wählen Sie "Ja", wenn Sie Kommentare für jede Aufgabe erhalten möchten. Wählen Sie "Archivieren", wenn Sie Aufgaben aus dem Archiv abrufen möchten. Weitere Informationen zu Archivausgabedaten finden Sie in den restlichen optionalen Parametern. Nur anwendbar mit Container = "Archiv". Das Datum, nach dem die Aufgaben archiviert wurden. Akzeptiert das Format: "2012-05-05". Standardbewertung ist ‚1970-01-01‘ Nur anwendbar mit Container = "Archiv". Das Datum, vor dem die Aufgaben archiviert wurden. Akzeptiert das folgende Format: "2012-05-05". Standard Wert ist ‚jetzt‘ Nur anwendbar mit container = "Archiv". Wenn dieser Parameter auf "1" gesetzt ist, gibt die Antwort nur Initiativen zurück. Andernfalls werden nur Aufgaben zurückgegeben. Gibt die Aufgaben aus der angegebenen Archivversion an. Die Parameter vondatum und bisdatum werden ignoriert. Nur anwendbar mit Container = "Archiv". Mit diesem Parameter steuern Sie, welche Seitennummer erhalten werden soll. Die Methode gibt 30 Aufgaben pro Seite zurück. Wenn nicht gesetzt, werden die ersten 30 Werte zurückgegeben, d. h. „page“ = 1. Optionen: "plain" (Standard) und "html". Wenn das Nur-Text-Format verwendet wird, werden die HTML-Tags aus der Aufgabenbeschreibung entfernt.
Output taskid position type assignee title description subtasks subtaskscomplete color priority size deadline deadlineoriginalformat extlink tags columnid laneid workflow leadtime blocked blockedreason subtaskdetails comments columnname lanename columnpath logedtime* attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status]
Die ID der Aufgabe Die Position der Aufgabe Der Aufgabentyp Benutzername des Beauftragten Überschrift der Aufgabe Beschreibung der Aufgabe Anzahl der Teilaufgaben Anzahl der abgeschlossenen Teilaufgaben Farbe der Aufgabe Aufgabenpriorität Größe der Aufgabe Aufgabenstermin im Format Tag Monat (z. B. 01. August) Aufgabentermin im Format JJJJ-MM-TT (z. B. 2012-08-01) Aufgabenstermin im Format yyyy-mm-dd (e.g. 2012-08-01) Externer Link zur Aufgabe Aufgaben-Tags Die ID der Spalte, in der sich die Aufgabe befindet. Die ID der Swimlane, in der sich die Aufgabe befindet. Der Workflow, zu dem der Artikel gehört (0 – Karten-Workflow / 1 – Initiativen-Workflow) Vorlaufzeit in Tagen Ist die Aufgabe blockiert (0 – nein / 1 – ja) Warum ist die Aufgabe blockiert? Details aller Teilaufgaben (Teilaufgaben-ID, Teilaufgabenbeauftragter, Teilaufgabenüberschriftt, Teilaufgabendatum der Fertigstellung). Details eines Kommentars (Autor, Ereignis, Text, Datum, Aufgaben-ID). Der Name der Spalte, in der sich die Aufgabe befindet. Der Name der Swimlane, in der sich die Aufgabe befindet. Der vollständige Pfad zur Kartenspalte im Format: „Spalte.Unterspalte1.Unterspalte2“. Wenn sich die Aufgabe in einer Hauptspalte befindet, entspricht dies „Spaltenname“. Die akkumulierte protokollierte Zeit der Aufgabe in Stunden. * Es gibt einen fehlenden Buchstaben G, der nicht extra hinzugefügt wurde, um die Abwärtskompatibilität aufrechtzuerhalten. Array mit den Informationen über die neuen Dateien, die an die Karte angehängt sind. Eine Verknüpfung zu der Datei, wenn sie von einem Speicherdienst hinzugefügt wurde (Dropbox, Google Drive usw.). Der Name der Datei, die vom Benutzer hochgeladen wurde. Eindeutiger Name der Datei. Die Größe der Datei. Die Erweiterung der Datei. Upload-Status.

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_all_tasks/
Body beantragen: {"boardid":"17"}

Kommentar Hinzufugen [add_comment]


Benötigt comment taskid
Der Kommentar, der hinzugefügt werden soll. Die ID der Aufgabe, die Sie kommentieren möchten.
Optional n/a
Output id author date
ID des Geschichtsereignisses Autor des Kommentars Aktuelles Datum

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_comment/
Body beantragen: {"taskid":"173", "comment":"this is a test comment"}

Aufgabe Verschieben [move_task]


Mit dieser Aktion können Sie Aufgaben ans Board verschieben, indem Sie den Spaltennamen und optional den Namen der Swimlane angeben.

 

Benötigt boardid taskid
Die ID des Boards, auf dem sich die Aufgaben befinden. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der zu verschiebenden Aufgabe.
Optional column lane position* exceedingreason
Der Name der Spalte, in die die Aufgabe verschoben werden soll. Wenn der Name der Spalte einzigartig ist, können Sie ihn einzeln angeben. Wenn es jedoch mehrere Spalten mit diesem Namen gibt, müssen Sie ihn als Spaltenname1 angeben. Spaltenname2. Spaltenname3. Der Name der Swimlane, in die die Aufgabe verschoben werden soll. Wenn er weggelassen wird, ändert sich die Schwimmbahn nicht. Die Position der Aufgabe in der neuen Spalte (nullbasiert). Wenn sie weggelassen wird, wird die Aufgabe am Ende der Spalte platziert.
* Dieser Parameter wird beim Verschieben von Aufgaben auf ein anderes Board nicht berücksichtigt.
Wenn Sie ein Limit aus einem Grund überschreiten können, geben Sie diesen Parameter ein.
Output status
Der Status der Operation (1 oder Fehler).
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Body beantragen: {"boardid":"17", "taskid":"24", "column":"MyColumn"}
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Body beantragen: {"boardid":"17", "taskid":"24", "column":"MainColumn.SubColumn.MyColumn"}
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/move_task/
Body beantragen: {"boardid":"17", "taskid":"24", "column":"MainColumn.SubColumn.MyColumn", "lane":"Bugs"}

Aufgabe Bearbeiten [edit_task]


Mit dieser Aktion können Sie die Aufgabendetails aktualisieren.

 

Benötigt boardid taskid
Die ID des Boards, auf dem sich die Aufgaben befinden. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der zu bearbeitenden Aufgabe.
Optional title description priority assignee color size tags deadline extlink type < customfield >
Überschrift der Aufgabe Beschreibung der Aufgabe Einer der folgenden Werte: Niedrig, Mittel, Hoch, Kritisch Benutzername des Beauftragten (muss ein gültiger Benutzername sein) Beliebiger Farbcode (z. B. # 34a97b) ohne das Zeichen # vor dem Code. Größe der Aufgabe Durch Leerzeichen getrennte Liste von Tags Frist im Format: JJJJ-MM-TT (z. B. 2011-12-13) Ein Link im folgenden Format: https://domain.com/resource. Diese Option wird nur unterstützt, wenn Parameter im Anfragetext gesendet werden. Der Name des Typs, den Sie festlegen möchten. Ein benutzerdefiniertes Feld, das aktualisiert werden soll. Wenn das Feld auf der Karte nicht vorhanden ist, wird es automatisch mit dem angegebenen Wert zugewiesen.
Output status
Der Status der Operation (1 oder Fehler).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_task/
Body beantragen: {"boardid":"17", "taskid":"24", "title":"My new title", "description":"My new description", "size":"24"}

Aufgabe Blockieren [block_task]


Benötigt boardid taskid event blockreason
Die ID des Boards, auf dem sich die zu blockierende / zu entsperrende Aufgabe befindet. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der Aufgabe Mögliche Werte: 'Blockieren' – Blockieren einer Aufgabe; 'Block bearbeiten' – bearbeite den gesperrten Grund; Entsperren – Entsperren Sie eine Aufgabe Erforderlich, wenn das Ereignis auf 'Blockieren' oder 'Bearbeiten' eingestellt ist
Optional n/a
Output status
Der Status der Operation (1 oder Fehler).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/block_task/
Body beantragen: {"boardid":"2", "taskid":"1173", "event":"block", "blockreason":"Reason text"}


https://<subdomain>.kanbanize.com/index.php/api/kanbanize/block_task/
Body beantragen: {"boardid":"2", "taskid":"1173", "event":"unblock"}

Teilaufgabe Hinzufugen [add_subtask]


Benötigt taskparent
Die ID der Aufgabe, in der sich die zu erstellende Teilaufgabe befindet.
Optional title assignee
Überschrift der Teilaufgabe Benutzername des Beauftragten (muss ein gültiger Benutzername sein)
Output status
Die ID der neu erstellten Teilaufgabe oder 0, wenn ein Fehler aufgetreten ist.

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_subtask/
Body beantragen: {"taskparent":"254", "title":"sample subtask title", "assignee":"myusername"}

Teilaufgabe Bearbeiten [edit_subtask]


Benötigt boardid subtaskid
Die ID des Boards, auf dem sich die zu bearbeitende Teilaufgabe befindet. Sie können die Board-ID auf dem Dashboard-Bildschirm in der oberen rechten Ecke jedes Boards sehen. Die ID der Teilaufgabe
Optional title assignee complete
Überschrift der Teilaufgabe Benutzername des Beauftragten (muss ein gültiger Benutzername sein) Optionen: 1 oder 0. Wenn es auf 1 gesetzt ist, wird die Teilaufgabe als beendet markiert, andernfalls als unvollendet.
Output status
Der Status der Operation (1 oder Fehler).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_subtask/
Body beantragen: {"boardid":"68", "subtaskid":"673", "title":"new subtask title", "complete":"1"}

Arbeitszeit Erfassen [log_time]


Benötigt loggedtime taskid
Die Anzahl der Stunden, die Sie der Aufgabe hinzufügen möchten. Die ID der Aufgabe oder Teilaufgabe, zu der die Zeit protokolliert werden soll.
Optional description date
Kommentar zum Protokollzeiteintrag. Legt das Datum fest, für das die Uhrzeit protokolliert wird. Das akzeptierte Format ist JJJJ-MM-TT.
Output id historyid taskid author details loggedtime issubtask title comment origindate entrydate
Die ID des Log-Zeitereignisses. Die ID des Ereignisses (für die interne Verwendung). Die ID der Aufgabe oder Unteraufgabe, die mit einem Protokollzeit-Ereignis aktualisiert wurde. Der Benutzername des API-Benutzers, der die Aufgabe aktualisiert hat. Nachricht, die das Protokollzeit-Ereignis erläutert. Die Anzahl der Stunden, die protokolliert wurden. Ein boolescher Parameter, der anzeigt, ob die Aufgabe eine Teilaufgabe ist oder nicht. Die Überschrifz der Aufgabe, die aktualisiert wurde. Der Kommentar, der zusammen mit dem Zeitprotokoll hinzugefügt wurde. Zeitstempel des Ereignisses (keine Zeitzone angewendet). Zeitstempel des Ereignisses (Zeitzone angewendet).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/log_time/
Body beantragen: {"taskid":"68", "loggedtime":"673"}

Links Holen [get_links]


Der Aufruf dieser Methode gibt ein Array zurück, das die Verbindungsdaten enthält. Aufgaben, die keine Links enthalten, werden weggelassen.

Benötigt boardid or taskid

boardid: Eine Ganzzahl oder ein Array von ganzen Zahlen. Daten für die Links aller Aufgaben werden zurückgegeben; aufgabenid: Eine Ganzzahl oder ein Array von ganzen Zahlen, für die die Verbindungsdaten zurückgegeben werden.

Optional boardid taskid
Eine einzelne Ganzzahl oder ein Array von Ganzzahlen, die Board-IDs angeben. Daten für die Links aller Aufgaben in den Boards werden zurückgegeben. Eine einzelne Ganzzahl oder ein Array mit Ganzzahlen, die die Aufgaben-IDs angeben, für die die Verbindungsdaten zurückgegeben werden.
Output taskid parent children mirrors relatives predecessors successors
Die ID der Aufgabe, zu der die Linkdaten gehören. Die Aufgaben-ID der Aufgabe, die als Parent zugewiesen wurde. Ein Array von Aufgaben-IDs, die untergeordnete Elemente der Aufgabe sind. Ein Array von Aufgaben-IDs, die Spiegel der Aufgabe sind. Ein Array von Aufgaben-IDs, die mit der Aufgabe verwandt sind. Ein Array von Aufgaben-IDs, die Vorgänger der Aufgabe sind. Ein Array von Aufgaben-IDs, die Nachfolger der Aufgabe sind.

http://<subdomain>.kanbanize.com/index.php/api/kanbanize/get_links/
Body beantragen: {"taskid":[17,27], "boardid":"4"}

Link Bearbeiten [edit_link]


Benötigt taskid action type linkedid
Die ID der Aufgabe, die verknüpft werden soll. Optionen: "eingestellt" oder "nicht eingestellt" Optionen: 'Kind', 'Eltern', 'Verwandter', 'Spiegel', 'Vorgänger', 'Nachfolger'. Für alle Linktypen lautet die Logik wie folgt: Machen Sie {aufgabenid} einen {typ} von {verlinkterid} Die ID der Aufgabe, die mit {aufgabenid} verknüpft wird.
Optional n/a
Output status
Der Status der Operation (1 oder Fehler).

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_link/
Body beantragen: {"taskid":"17", "action":"set", "linkedid":"27", "type":"relative"}

Anhang Hinzufugen [add_attachment]


Diese Funktion unterscheidet sich von den anderen. Die Anfrage sollte als multipart / form-data kodiert sein. Ein Teil sollte params heißen und sollte einen JSON mit der boardid und aufgabenid der Aufgabe enthalten, der Sie einen Anhang hinzufügen möchten. Die anderen Teile (zwischen 1 und 5) sollten die Datei (en) enthalten, die im Binärformat angehängt werden sollen.

Output attachments attachments[][url] attachments[][clientName] attachments[][uniqueName] attachments[][fileSize] attachments[][fileType] attachments[][status]
Array mit den Informationen über die neuen Dateien, die an die Karte angehängt sind. Eine Verknüpfung zu der Datei, wenn sie von einem Speicherdienst hinzugefügt wurde (Dropbox, Google Drive usw.) Der Name der Datei, die vom Benutzer hochgeladen wurde. Einzigartiger Name der Datei. Die Größe der Datei. Die Erweiterung der Datei. Upload-Status.
https://<subdomain>.kanbanize.com/index.php/api/kanbanize/add_attachment/

Headers beantragen:
content-type: multipart/form-data; boundary=AnyStringNotFoundInTheBody
apikey:
Body beantragen:
--AnyStringNotFoundInTheBody
Content-Disposition: form-data; name="params"
{"taskid":"12345","boardid":"1"}
--AnyStringNotFoundInTheBody
Content-Disposition: form-data; name="Screenshot.png"; filename="Screenshot.png"
Content-Type: image/png
[binary image data]
--AnyStringNotFoundInTheBody--

Aufgaben Archivieren [archive_task]


Benötigt cardid
ID oder IDs der Karten, die archiviert werden. Die Karten dürfen nicht gesperrt sein, in der Spalte Fertig oder in der Spalte Archiv.
Optional version
Version des Archivs. Wenn ausgewählt, kann es nicht leer sein, kann aber auch kein Array von Werten sein.
Output status
Status 1 (Wahr) bei erfolgreicher Operation oder Fehler bei Falsch.

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/archive_task
Body beantragen: {"cardid":[17,321], "version":"name-of-the-versions"}

Benutzerdefinierte Felder Bearbeiten [edit_custom_fields]


Benötigt cardid fields fields[][name] fields[][value]
Die ID der Karte, für die Sie ein benutzerdefiniertes Feld anwenden möchten. Das benutzerdefinierte Feld sollte bereits erstellt worden sein. Ein Array der benutzerdefinierten Felder. Der Name des benutzerdefinierten Felds. Muss gültigem benutzerdefiniertem Feld pro Board entsprechen. Der Wert des benutzerdefinierten Felds. Der Werttyp sollte derselbe wie in der benutzerdefinierten Felddeklaration sein.
Optional n/a
Output status
Status 1 (Wahr) bei erfolgreicher Operation oder Fehler bei Falsch.

https://<subdomain>.kanbanize.com/index.php/api/kanbanize/edit_custom_fields
Body beantragen: {"cardid":"17", "fields":[{"name":"price", "value":"233"}, {"name":"mail", "value":"ex@test.com"}]}

Anhang Holen [get_attachment]


Verwenden Sie diesen Aufruf, um Anhänge herunterzuladen.

Benötigt taskid uniquename

Die ID der Karte mit dem Anhang.

Der eindeutige Name-Parameter des Anhangs. Kann über aufgabendetails_aufrufen oder alle_aufgaben_aufrufen abgerufen werden.

Optional thumbnail encoding
Setzen Sie diese Option auf "Ja", wenn Sie eine Miniaturansicht des ursprünglichen Anhangs erhalten möchten. Gilt nur für Bilddateien. Gibt die Codierung an, in der die Datei zurückgegeben wird. Unterstützte Formate sind 'binary' und 'base64'. Standard ist 'binär'. Beachten Sie, dass das Antwortformat bei Auftreten eines Fehlers durch den URL-Parameter 'format' bestimmt wird.
Output Anhang Daten oder Fehler

https://.kanbanize.com/index.php/api/kanbanize/get_attachment/
Body beantragen: {"taskid":"27", "uniquename":"uniqueNameOfTheFile.txt"}

Beeindruckend, nicht wahr? Testen Sie es jetzt kostenlos!

Das Testkonto in Kanbanize bietet nahezu ohne Einschränkungen Zugriff auf alle Funktionen im System. Während der 30-tägigen Testperiode können Sie auch Ihr Team einladen, die App in einer produktiven Umgebung zu testen.

Digitale Plattform für klassische Kanban-Karten

Kanban-Produktmanagement ist ein bewährtes System, genutzt von den erfolgreichsten Unternehmen und Teams weltweit. Dieses System setzt Karten ein, um große und komplexe Projekte in kleinere und überschaubare Aufgaben aufzuteilen.

Kanbanize verwendet digitale Boards mit Kanban-Karten. Damit können Sie und Ihr Team:

  • Karten am Kanban-Board verschieben, damit Teams den Arbeitsfortschritt visualisieren können
  • Die Anzahl der zu einer Person zugewiesen Karten limitieren, um ein bewältigbares Arbeitspensum und höchste Effizienz von jedem Teammitglied zu sichern
  • Verschiedene Karten-Typen erstellen und Nutzern ermöglichen nur für ihre Arbeit relevante Karten zu sehen
  • Kanban-Kartenvorlagen mit vordefinierten Attributen und Subtasks verwenden
  • Obligatorische oder optionale benutzerdefinierte Felder festlegen

Unser Kanban-Board mit Karten stellt eine moderne und digitale Represantation der klassischen Kanban-Karten, die das System bekannt gemacht haben, dar. Als Nutzer bekommen Sie ein erprobtes und bewährtes Produktivitäts- und Effizienzsystem auf einer funktionalen digitalen Plattform.

Viele Softwareunternehmen versuchen aus dem Erbe des Kanban-Managements Kapital zu schlagen. Manche Kanban-Softwareanbieter bieten zwar die Tools, die Sie benötigen, die aber aufgrund ihres benutzerunfreundlichen Interfaces schwer zu bedienen sind. Andere bieten wiederum eine benutzerfreundliche Software, die aber die notwendigen Tools fürs Erreichen maximaler Produktivität und Effizienz vermisst. Kanbanize liefert das beste System mit Kanban-Karten aus einem einfachen Grund: Wir bieten eine Vielfalt von leistungsstarken Funktionen in einem benutzerfreundlichen Interface, das eine schlelle Anwendung ermöglicht.

Entscheiden Sie sich für Kanbanize und genießen Sie bis zu 300 Prozent Produktivitätssteigerung. Wenn Sie unsere Kanban-Karten testen wollen, nutzen Sie unser 30-tägiges kostenloses Probeabo. Sie werden die Vorteile und den Nutzen, die Kanbanize Teams und Unternehmen jeder Größe bietet, schnell erkennen.

Loslegen →

Werden Sie ein Teil unserer Familie!
  • Continental Corporation
  • Mozilla
  • BCG Digital Ventures
  • Tokyo Electron
  • Bose
  • Indiana University
  • Orange Business Services
  • GoDaddy
  • Arsenal Football Club
  • Roche Diagnostics

Immer bei dir, unterwegs

Greifen Sie mit unseren mobilen Apps auf all Ihre Projekte und Boards zu. Mit unseren mobilen Apps kannst du Karten ansehen, erstellen, aktualisieren, löschen und verschieben, Kommentare posten und vieles mehr.