Adressen ä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 Anschriften verfügen. Wenn Sie eine neue Anschrift erfassen, wird die alte Anschrift hierdurch nicht automatisch ungültig.

Anstatt eine ungültige Adresse zu löschen, empfehlen wir, die alte Adresse mit einem Enddatum zu versehen. Diese Eigenschaft kann im Feld "ValidTo" hinterlegt werden.

Hierdurch wird die Nachvollziehbarkeit in WOWIPORT für alte Anschriften gewährleistet.

Eine neue Adresse zur Person erfassen

Version 1.0

---

post

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Rumpf

application/jsontext/jsonapplication/*+json

AddressTypeIdinteger · int32 | nullfähigOptional

Zipstring | nullfähigOptional

Townstring | nullfähigOptional

Streetstring | nullfähigOptional

HouseNumberstring | nullfähigOptional

HouseNumberAdditionstring | nullfähigOptional

CountryIdinteger · int32 | nullfähigOptional

ValidFromstring · dateOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date | nullfähigOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

Antworten

201

Created

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /openwowi/v1.0/PersonsWrite/Person/{personId}/Addresses HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "AddressTypeId": 1,
  "Zip": "text",
  "Town": "text",
  "Street": "text",
  "HouseNumber": "text",
  "HouseNumberAddition": "text",
  "CountryId": 1,
  "ValidFrom": "2025-10-13",
  "ValidTo": "2025-10-13"
}

application/jsontext/jsonapplication/*+json

1

---

Version 1.2

---

post

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Rumpf

application/jsontext/jsonapplication/*+json

AddressTypeIdinteger · int32 | nullfähigOptional

Zipstring | nullfähigOptional

Townstring | nullfähigOptional

Streetstring | nullfähigOptional

HouseNumberstring | nullfähigOptional

HouseNumberAdditionstring | nullfähigOptional

CountryIdinteger · int32 | nullfähigOptional

ValidFromstring · dateOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date | nullfähigOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

Antworten

201

Created

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /openwowi/v1.2/PersonsWrite/Person/{personId}/Addresses HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "AddressTypeId": 1,
  "Zip": "text",
  "Town": "text",
  "Street": "text",
  "HouseNumber": "text",
  "HouseNumberAddition": "text",
  "CountryId": 1,
  "ValidFrom": "2025-10-13",
  "ValidTo": "2025-10-13"
}

application/jsontext/jsonapplication/*+json

1

---

Eine bestehende Adresse ändern

Version 1.0

---

put

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

childIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Rumpf

application/jsontext/jsonapplication/*+json

AddressTypeIdinteger · int32 | nullfähigOptional

Zipstring | nullfähigOptional

Townstring | nullfähigOptional

Streetstring | nullfähigOptional

HouseNumberstring | nullfähigOptional

HouseNumberAdditionstring | nullfähigOptional

CountryIdinteger · int32 | nullfähigOptional

ValidFromstring · dateOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date | nullfähigOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

Antworten

200

OK

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

put

HTTPcURLJavaScriptPython

PUT /openwowi/v1.0/PersonsWrite/Person/{personId}/Addresses/{childId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "AddressTypeId": 1,
  "Zip": "text",
  "Town": "text",
  "Street": "text",
  "HouseNumber": "text",
  "HouseNumberAddition": "text",
  "CountryId": 1,
  "ValidFrom": "2025-10-13",
  "ValidTo": "2025-10-13"
}

application/jsontext/jsonapplication/*+json

1

---

Version 1.2

---

put

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

childIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Rumpf

application/jsontext/jsonapplication/*+json

AddressTypeIdinteger · int32 | nullfähigOptional

Zipstring | nullfähigOptional

Townstring | nullfähigOptional

Streetstring | nullfähigOptional

HouseNumberstring | nullfähigOptional

HouseNumberAdditionstring | nullfähigOptional

CountryIdinteger · int32 | nullfähigOptional

ValidFromstring · dateOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date | nullfähigOptionalExample: 2025-10-13Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

Antworten

200

OK

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

put

HTTPcURLJavaScriptPython

PUT /openwowi/v1.2/PersonsWrite/Person/{personId}/Addresses/{childId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "AddressTypeId": 1,
  "Zip": "text",
  "Town": "text",
  "Street": "text",
  "HouseNumber": "text",
  "HouseNumberAddition": "text",
  "CountryId": 1,
  "ValidFrom": "2025-10-13",
  "ValidTo": "2025-10-13"
}

application/jsontext/jsonapplication/*+json

1

---

Eine bestehende Adresse löschen

Version 1.0

---

delete

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

childIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

delete

HTTPcURLJavaScriptPython

DELETE /openwowi/v1.0/PersonsWrite/Person/{personId}/Addresses/{childId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

1

---

Version 1.2

---

delete

Autorisierungen

Authorization

Pfadparameter

personIdinteger · int32Erforderlich

childIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Antwortinteger · int32

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

delete

HTTPcURLJavaScriptPython

DELETE /openwowi/v1.2/PersonsWrite/Person/{personId}/Addresses/{childId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

1

---