Diese Operation kann genutzt werden, um für den gegebenen Account eine neue Domain zu registrieren oder einen Virtual Host Eintrag zu erstellen. Falls die Domain bereits vergeben ist, müssen ein Auth-Code und unter Umständen ein Authentifizierungsverfahren mitangegeben werden, um einen Domain-Transfer einzuleiten.

Request

POST https://api.mittwald.de/v1/accounts/{accountIdentifier}/domains

Pfad-Parameter

Parametername Wert Beschreibung Weiteres
accountIdentifier string

Name oder ID eines Accounts

Pflichtangabe

Request-Body

The request body takes a complete DomainRegistration resource, containing the following writable properties:

{
    "domainNameTransfer": {
        "authInfoProcedure": "integer",
        "authcode": "string"
    },
    "external": "boolean",
    "handles": {
        "admin": {
            "city": "string",
            "company": "string",
            "country": "string",
            "emailAddress": "email",
            "fax": "string",
            "firstName": "string",
            "houseNumber": "string",
            "lastName": "string",
            "salutation": "string",
            "street": "string",
            "title": "string",
            "zip": "string"
        },
        "owner": {
            "city": "string",
            "company": "string",
            "country": "string",
            "emailAddress": "email",
            "fax": "string",
            "firstName": "string",
            "houseNumber": "string",
            "lastName": "string",
            "salutation": "string",
            "street": "string",
            "title": "string",
            "zip": "string"
        }
    },
    "sld": "string",
    "target": "string",
    "tld": "string"
}

Properties

Name Typ Beschreibung Weiteres
domainNameTransfer object DomainNameTransfer Optional
domainNameTransfer.authInfoProcedure integer

1 für das AuthInfo1 Verfahren oder 2 für das AuthInfo2 Verfahren

Mögliche Werte sind:

  • %!s(float64=1)
  • %!s(float64=2)
Optional
domainNameTransfer.authcode string Optional
external boolean

Gesetzt, wenn es sich um einen Virtual Host Eintrag handeln soll

Optional
handles object Handles Optional
handles.admin object Contact Optional
handles.admin.city string
handles.admin.company string Optional
handles.admin.country string

iso country short code (ISO 3166-1 alpha-2)

handles.admin.emailAddress email
handles.admin.fax string Optional
handles.admin.firstName string
handles.admin.houseNumber string
handles.admin.lastName string
handles.admin.salutation string

Mögliche Werte sind:

  • Herr
  • Frau
  • Mr.
  • Ms.
handles.admin.street string
handles.admin.title string Optional
handles.admin.zip string of integer
handles.owner object Contact Optional
handles.owner.city string
handles.owner.company string Optional
handles.owner.country string

iso country short code (ISO 3166-1 alpha-2)

handles.owner.emailAddress email
handles.owner.fax string Optional
handles.owner.firstName string
handles.owner.houseNumber string
handles.owner.lastName string
handles.owner.salutation string

Mögliche Werte sind:

  • Herr
  • Frau
  • Mr.
  • Ms.
handles.owner.street string
handles.owner.title string Optional
handles.owner.zip string of integer
sld string
target string

Bei Virtual Host Einträgen kann direkt das Zielverzeichnis mit angegeben werden

Optional
tld string

Response

Diese Operation kann mit den folgenden HTTP-Statuscodes antworten:

Statuscode Beschreibung Ressource
201 Created

Die erstellte Domain

Domain[]
400 Bad Request

Fehlendes oder fehlerhaftes Argument.


Explore this API

accountIdentifier

Name oder ID eines Accounts

body

Daten für eine Domain-Registrierung

Request Content-Type
Response Content-Type
Try it out!