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.