====== design2budget Entwickler Webservice Dokumentation ======

Zurück zur [[design2budget:webservice|Webservice Dokumentation Startseite]]

====== Basisoperation <module>/save ======

Diese Action wird von jedem Modul angeboten und speichert ein Objekt des angegebenen Moduls mit der angegebenen id.

Jedes Objekt hat als primary key das Feld id.

Wird statt einer gültigen id 0 angegeben, so wird ein neues Objekt erzeugt. 

Die Feldwerte werden als POST Paramter übergeben.

==== GET ====

https://server/tenant/s/module/save/id/?sid=sessionID[&output=outputMode]

^  parameter    ^ Optional: Standard ^ Beschreibung     ^
| output        | JA: json           | JSON REST API (json) oder XML REST API (xml) |

Beispiel:

https://server/tenant/s/offer/save/312/?sid=9bd3b5f93692e4659632c8585eb35447

Speichert das Angebot 312

==== POST ====

Die einzelnen Werte für jedes Feld werden direkt als POST Parameter übergeben

^ Parameter    ^ Beschreibung    ^
| <field1>=<value1>  | Das angegebene Feld field1 wird auf den Wert value1 gesetzt |
| <field2>=<value2>  | Das angegebene Feld field2 wird auf den Wert value2 gesetzt |
| <field...>=<value...>  | Jedes weitere Feld wird auf den entsprechenden Wert gesetzt |

**ACHTUNG:** Die Angabe der id als POST Paramter ist nicht zulässig!

=== Beispiel1: Updaten eines Records ===

https://server/tenant/s/customer/save/33/?sid=9bd3b5f93692e4659632c8585eb35447

POST body:
<code>
lastname=Mustermann
firstname=Max
email=max.mustermann@domain.tld
</code>

Führt ein Update beim Kunden mit id 33 durch und speichert (überschreibt) die Felder lastname, firstname und email.

=== Beispiel2: Neuanlage eines Records === 

https://server/tenant/s/customer/save/0/?sid=9bd3b5f93692e4659632c8585eb35447

POST body:
<code>
lastname=Mustermann
firstname=Max
email=max.mustermann@domain.tld
</code>

Legt einen neuen Kunden an und setzt die Felder lastname, firstname und email.