Kontakt-Handles

Kontakt-Handle erstellen

Erstellt einen neuen Satz von Kontaktdaten. Ein Handle bündelt die Informationen für Eigentümer- (Owner), Admin- und Tech-Kontakte.

URL: POST /api/v1/organizations/{organizationId}/contact-handles

Anfrage-Body:

{
  "contactHandleName": "Standard Geschäftsführung",
  "owner": {
    "firstName": "Max",
    "lastName": "Mustermann",
    "organizationName": "STACKIT GmbH & Co. KG",
    "street": "Stiftsbergstraße",
    "houseNumber": "1",
    "city": "Neckarsulm",
    "postalCode": "74172",
    "countryCode": "DE",
    "emailAddress": "info@stackit.de",
    "phoneNumberPrefix": "+49",
    "phoneNumber": "7132 30474747"
  },
  "admin": {
    /* Identisch zu owner oder abweichend */
  },
  "tech": {
    /* Identisch zu owner oder abweichend */
  }
}

Alle Kontakt-Handles abrufen

Listet alle verfügbaren Kontakt-Handles für Ihre Organisation auf.

URL: GET /api/v1/organizations/{organizationId}/contact-handles

Standard-Handle der Organisation festlegen

Definiert ein Handle als Standard. Dieses Handle wird automatisch verwendet, wenn bei einer Domain-Bestellung keine spezifische ID angegeben wird.

URL: PATCH /api/v1/organizations/{organizationId}/contact-handles/organization-default

Anfrage-Body:

{ "contactHandleId": "5bac8419-0d76-44c1-9216-7da5eb7d0ec2" }

Kontakt-Handle löschen

Entfernt ein bestimmtes Kontakt-Handle aus der Organisation. Wichtige Regel: Ein Handle kann nur gelöscht werden, wenn es derzeit keiner aktiven Domain zugewiesen ist und nicht als Standard-Handle der Organisation festgelegt ist.

URL: DELETE /api/v1/organizations/{organizationId}/contact-handles/{contactHandleId}

Antwort (Erfolgreich gelöscht):

204 No Content