Kontaktwege ändern

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Hinweise zur Funktion

Eine Person kann über mehrere Kommunikationswege verfügen. Wenn Sie einen neuen Kommunikationsweg erfassen, wird der alte Kommunikationsweg hierdurch nicht automatisch ungültig.

Im Gegensatz zu Adressen können die Kontaktwege nicht mit einem Ablaufdatum versehen werden. Wenn ein Kontaktweg nicht länger verwendet werden darf, muss dieser entweder gelöscht werden, oder eine dazugehörige Anschrift muss über das Ablaufdatum für ungültig erklärt werden.

Bitte beachten Sie, dass ein Kontaktweg selbst bei einer ungültigen Anschrift noch angezeigt wird. Betrachten Sie einen Kontaktweg mit einer zugeordneten Anschrift deshalb immer im Kontext der Gültigkeit der zugeordneten Anschrift.

Neue Kommunikationswege erfassen

Version 1.0

---

POST/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications

Authorization

Authorization

Path parameters

personId*integer (int32)

Query parameters

Body

application/jsontext/jsonapplication/*+json

CommunicationTypeIdinteger (int32)

RelatedAddressIdnullable integer (int32)

Contentnullable string

Explanationnullable string

Response

201400401

Created

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400

1

---

Version 1.2

---

POST/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications

Authorization

Authorization

Path parameters

personId*integer (int32)

Query parameters

Body

application/jsontext/jsonapplication/*+json

CommunicationTypeIdinteger (int32)

RelatedAddressIdnullable integer (int32)

Contentnullable string

Explanationnullable string

Response

201400401

Created

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400

1

---

Bestehende Kommunikationswege ändern

Version 1.0

---

PUT/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications/{childId}

Authorization

Authorization

Path parameters

personId*integer (int32)

childId*integer (int32)

Query parameters

Body

application/jsontext/jsonapplication/*+json

CommunicationTypeIdinteger (int32)

RelatedAddressIdnullable integer (int32)

Contentnullable string

Explanationnullable string

Response

200400401

OK

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications/{childId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400

1

---

Version 1.2

---

PUT/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications/{childId}

Authorization

Authorization

Path parameters

personId*integer (int32)

childId*integer (int32)

Query parameters

Body

application/jsontext/jsonapplication/*+json

CommunicationTypeIdinteger (int32)

RelatedAddressIdnullable integer (int32)

Contentnullable string

Explanationnullable string

Response

200400401

OK

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications/{childId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400

1

---

Bestehende Kommunikationswege löschen

Version 1.0

---

DELETE/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications/{childId}

Authorization

Authorization

Path parameters

personId*integer (int32)

childId*integer (int32)

Query parameters

Response

200400401

OK

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.0/PersonsWrite/Person/{personId}/Communications/{childId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200400

1

---

Version 1.2

---

DELETE/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications/{childId}

Authorization

Authorization

Path parameters

personId*integer (int32)

childId*integer (int32)

Query parameters

Response

200400401

OK

Body

text/plainapplication/jsontext/json

integer (int32)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/openwowi/v1.2/PersonsWrite/Person/{personId}/Communications/{childId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200400

1

---