Domain registrieren/Transfer einleiten

POST/v1/accounts/{accountIdentifier}/domains

API version

v1

Request method

POST

Operation ID

registerNewDomain

---

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

• accountIdentifierstringrequired

  Name oder ID eines Accounts

Responses

Format

application/json

Description

Die erstellte Domain

• Array[
  • *object
    • namestringrequired
    • fullnamestringrequired
    • registryStatusstring
    • tldstringrequired
  ]

Content-Type: application/json

[
  {
    "name": "string",
    "fullname": "string",
    "registryStatus": "string",
    "tld": "string"
  }
]

{
  "type": "array",
  "items": {
    "title": "Domain",
    "type": "object",
    "required": [
      "name",
      "fullname",
      "tld"
    ],
    "properties": {
      "name": {
        "type": "string"
      },
      "fullname": {
        "type": "string"
      },
      "registryStatus": {
        "type": "string"
      },
      "tld": {
        "type": "string"
      }
    }
  }
}

Usage examples

$ curl \
    --fail \
    --location \
    -X POST \
    -d '{"handles":{"owner":{"firstName":"string","lastName":"string","title":"string","salutation":"Herr","street":"string","houseNumber":"string","zip":"string","city":"string","company":"string","emailAddress":"email@mittwald.example","country":"string","fax":"string"},"admin":{"firstName":"string","lastName":"string","title":"string","salutation":"Herr","street":"string","houseNumber":"string","zip":"string","city":"string","company":"string","emailAddress":"email@mittwald.example","country":"string","fax":"string"}},"sld":"string","tld":"string","domainNameTransfer":{"authcode":"string","authInfoProcedure":123},"external":true,"target":"string"}' \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    -H 'Content-Type: application/json' \
    https://api.mittwald.de/v1/accounts/string/domains