Kontaktdaten ändern

Beschreibung

Mit dieser Methode können Sie die Stammdaten eines vorhandenen Kontaktes ändern.

Anfrage

Syntax

PUT /v2/customer/<UUID_des_Kunden>/contact/<UUID_des_Kontaktes> HTTP/1.1
Host: api.cobai.com
Date: Datum/Uhrzeit
Content-Length: Länge
Content-Type: application/xml
Authorization: Signatur

Request-Parameter

Diese Methode benutzt keine zusätzlichen Request-Parameter

Request-Header

Diese Methode benutzt zusätzlich zu den Standard-Requestheadern keine weiteren Header.

Request-Body

Im Request-Body erwartet die Methode ein XML-Dokument mit den Daten des zu ändernden Kontaktes innerhalb des Root-Elements <contact/>. Die folgenden Felder können übergeben werden:

Feldname Pflicht Typ Bemerkung
gender   Geschlecht des Kontaktes, beachten Sie hierzu auch die Hinweise zu Geschlechtsangaben.
firstName C(35)  
lastName C(35)  
officePhone   C(30)  
officeFax   C(30)  
officeMobile   C(30)  
officeMail C(200)  
webUserName C(80)  
webPassword C(50) Übergeben Sie das Passwort als Klartext.
Wir speichern nur einen Hash des Passwortes, Sie können es also nachfolgend nicht wieder auslesen.
role   Die Nutzerrolle des anzulegenden Kontaktes. Bitte beachten Sie hierzu die Hinweise zu Benutzerrollen.
ignoreAssortment   true wenn für diesen Kontakt Sortimente ignoriert werden sollen, sonst false.

Das vorhandene Passwort wird nur geändert wenn das übergebene Passwort nicht leer ist (mindestens ein nicht-Whitespace enthält).

Antwort

Im Erfolgsfall werden im Zielsystem die Daten des Kontaktes geändert. Sie erhalten als Antwort ein Antwortdokument mit den gespeicherten Kontaktdaten.

Fehlerfall

Im Fehlerfall wird kein neuer Kontakt angelegt. Sie erhalten als Antwort HTTP-Status 400 Bad Request und ein BadRequest Antwort-Dokument.

Antwortheader

Location : Im Location-Header erhalten Sie die URL des neu angelegten Kontaktes.

Antwortdokument

Als Antwort auf die Anfrage erhalten sie ein Antwortdokument mit folgendem Inhalt:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contact xmlns:atom="http://www.w3.org/2005/atom">
    <firstName>Rico</firstName>
    <gender>MALE</gender>
    <ignoreAssortment>false</ignoreAssortment>
    <lastName>Blaa</lastName>
    <officeFax></officeFax>
    <officeMail>rico@blaa.de</officeMail>
    <officeMobile></officeMobile>
    <officePhone></officePhone>
    <role>ROLE_SHOP_COSTCENTER_USER</role>
    <atom:link rel="self" href="http://api.cobai.com/v1/customer/b00de3c0-f685-42d5-92b5-c46f04803c8f/contact/683aacec-1225-4fe5-a71b-cbb0010fe1eb"/>
    <uuid>683aacec-1225-4fe5-a71b-cbb0010fe1eb</uuid>
    <webUserName>rico</webUserName>
</contact>