Suche in diesem Bereich

Skip to end of metadata
Go to start of metadata


Table of Contents

Function

The DomainCreate task registers a domain.
In contrast to DomainCreate, DomainCreatePlus allows you to enter the data of a domain contact (handle). The domain contact is then created automatically. If a contact already exists with this data, no new one is created, but the existing one is used.

The DomainCreatePlus task is currently not supported for JSON.

Description

The keywords for the domain element are described on the Domain object page.
The keywords for the domain contact elements (ownerc, adminc, techc, zonec) for the DomainCreatePlus task are described on the Contact page.

Route: POST /domain

Request
{
   "name": "example.com",
   "ownerc": {
      "id": 23142212
   },
   "adminc": {
      "id": 23142212
   },
   "techc": {
      "id": 23142212
   },
   "confirmOrder": false,
   "nameServers": [
      {
         "name": "ns1.example.com"
      },
      {
         "name": "ns2.example.com"
      }
   ]
}
Response
{
    "stid": "20190628-app2-dev-23512",
    "status": {
        "code": "N0101",
        "text": "Domain registration was started successfully.",
        "type": "NOTIFY"
    },
    "object": {
        "type": "Domain",
        "value": "example.com"
    },
    "data": [
        {
            "created": "2019-06-28T15:12:48.000+0200",
            "updated": "2019-06-28T15:12:47.000+0200",
            "owner": {
                "context": 4,
                "user": "exampleuser"
            },
            "updater": {
                "context": 4,
                "user": "exampleuser"
            },
            "status": "RUNNING",
            "execution": "2019-06-28T15:12:46.000+0200",
            "id": 4297540445
        }
    ]
}

Task code: 0101
Uses Domain object

Example for Domain Create

Request
<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0101</code>
        <domain>
            <name>example.com</name>
            <ctid>my-ctid</ctid>
            <ownerc>21653083</ownerc>
            <adminc>21653083</adminc>
            <techc>21653083</techc>
            <zonec>21653083</zonec>
            <nserver>
                <name>ns1.example.com</name>
                <ip>172.16.100.1</ip>
                <ip6>2001:0DB8::1</ip6>
            </nserver>
            <nserver>
                <name>ns2.example.com</name>
                <ip>172.16.100.2</ip>
                <ip6>2001:0DB8::2</ip6>
            </nserver>
            <confirm_order>1</confirm_order>
            <use_trustee>1</use_trustee>
        </domain>
        <reply_to>customer@example.com</reply_to>
    </task>
</request>
Response
<response>
	<result>
		<data>
			<domain_job>
				<job>
					<id>4295210866</id>
					<status>RUNNING</status>
				</job>
			</domain_job>
		</data>
		<msg>
			<text>Whois query: TIMEOUT (Whois-based checks without warranty.</text>
			<code>MSG00003</code>
			<type>notice</type>
		</msg>
		<status>
			<code>N0101</code>
			<text>Domain registration was started successfully.</text>
			<type>notify</type>
			<object>
				<type>domain</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
	<stid>20180213-app3-11408</stid>
</response>

Possible Error Messages

  • EF01010 Invalid ZoneC.
  • EF010101 Language-Tag invalid.
  • EF010102 "Description" not allowed! Use owner-c instead.
  • EF010103 The domain can be registered via the drop zone only.
  • EF010104 An ownerchange with different contact types (PERSON, ORG) is not possible. Please contact our support.
  • EF01011 Invalid Nameserver.
  • EF010110 This TLD cannot be registered at this time.
  • EF01012 This domain does not exist.
  • EF01013 The domain already exists.
  • EF01014 Nameserver has been entered twice
  • EF01015 Invalid AuthInfo.
  • EF01016 Invalid registration period.
  • EF01017 Invalid OwnerC.
  • EF01018 Invalid BillingC.