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

• accountIdentifierstring

  required

  Name oder ID eines Accounts

Responses

Format

application/json

Description

Die erstellte Domain

Schema documentation

• Array[
• *object
  • namestring

    required
  • fullnamestring

    required
  • registryStatusstring
  • tldstring

    required
]

Example

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

JSON Schema

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

$ 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