System-API: Kunden
Aus sourceDESK Wiki
Version vom 5. Oktober 2018, 12:37 Uhr von Richard Reiber (Diskussion | Beiträge)
Der nachfolgend beschriebene API-Endpoint hat die URL /client
. Zur Verwendung der System-API konsultieren Sie bitte die Grundsätze der System-API.
Inhaltsverzeichnis
GET (alle Kunden)
Erwartete Parameter
Keine
Rückgabe
JSON-Array mit allen Kunden und jeweils den folgenden Elementen:
- ID
- firstname
- lastname
- company
GET (ein Kunde)
URL
/client/CLIENT_ID
Erwartete Parameter
Keine
Rückgabe
JSON-Array mit allen Daten des Kunden
POST (Kunde anlegen)
Erwartete Parameter
- firstname
- lastname
- pwd (optional, wenn nicht gegeben wird ein Passwort generiert)
Rückgabe
JSON-Array mit Element "id", der ID des neuen Kunden
Falls kein Passwort gesetzt wurde, wird das generierte Passwort als Element "pwd" zurückgegeben
PUT (Kunde bearbeiten)
URL
/client/CLIENT_ID
Erwartete Parameter
Es können alle Spalten aus der Tabelle clients
als Key verwendet werden. Als Value ist der gewünschte neue Wert zu übergeben.
Rückgabe
JSON-Array mit "status" = "ok"