Domain registrieren/Transfer einleiten

POST/v1/accounts/{accountIdentifier}/domains

API-Version

v1

Request-Methode

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

Beschreibung

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"
      }
    }
  }
}

Nutzungsbeispiele

$ 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