Zum Hauptinhalt springen

POST /cards

Beschreibung

Erstellt eine neue Karte und gibt ein JSON-Objekt mit einer neuen Karten-ID zurück.

Die Route verarbeitet die HTTP POST-Anfrage, die an den Pfad /cards gesendet wird.

Payload

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

NameTypBeschreibung
labelstringErforderlich. Der Name der neuen hinzuzufügenden Karte.
columnnumberErforderlich. Die Ziel-Spalten-ID.
rownumberErforderlich. Die Ziel-Zeilen-ID.

Beispiel:

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

Antwort

Die Route gibt ein JSON-Objekt mit einer neuen Karten-ID zurück.

Beispiel:

{ 
"id": 1
}

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


Verwandte Artikel: Working with server