Zum Hauptinhalt springen

POST /cards

Beschreibung

Fügt eine neue Karte hinzu und antwortet mit einem JSON-Objekt, das die ID der Karte enthält.

Dieser Endpunkt verarbeitet HTTP POST-Anfragen, die an die URL /cards gesendet werden.

Payload

Der Server erwartet ein JSON-Objekt mit den folgenden Feldern:

NameTypBeschreibung
labelstringErforderlich. Der Titel der zu erstellenden Karte.
columnnumberErforderlich. Die ID der Spalte, in der die Karte platziert wird.
rownumberErforderlich. Die ID der Zeile, in der die Karte positioniert wird.

Beispiel:

{
"label": "New card",
"column": 2,
"row": 1,
}

Antwort

Der Endpunkt antwortet mit einem JSON-Objekt, das die ID der neu erstellten Karte enthält.

Beispiel:

{ 
"id": 1
}

Der HTTP-Statuscode zeigt an, ob die Anfrage erfolgreich war (response.status == 200) oder ob ein Fehler aufgetreten ist (response.status == 500).


Verwandte Artikel: Working with server