Home
/
API reference
/
General API basics

Demo mode

API reference (XML/JSON) · Updated 2023-09-28

Description

In the demo mode, operations can be simulated in live AutoDNS. The demo mode is possible for all job types.

For testing the AutoDNS X3 and the interfaces (JSON, EPP, XML) a demo account to our AutoDNS Sandbox can be created. Please contact the sales department (vertrieb@internetx.com).

If the demo mode is active, the response contains the notification "MSG00001 - Demo mode active".

Example

Example of a DomainCreate in demo mode.

To activate the demo mode in JSON "true" must be specified in the HTTP header X-Domainrobot-Demo.

Route: POST /domain
HEADER: X-Domainrobot-Demo:true

{
   "name": "example.com",
   "ownerc": {
      "id": 23142212
   },
   "adminc": {
      "id": 23142212
   },
   "techc": {
      "id": 23142212
   },
   "confirmOrder": false,
   "nameServers": [
      {
         "name": "ns1.example.com"
      },
      {
         "name": "ns2.example.com"
      }
   ]
}

{
    "stid": "20190628-app2-dev-23512",
    "messages": [
        {
            "text": "Demo-Modus aktiv.",
            "code": "MSG00001",
            "status": "NOTICE"
        }
    ],
    "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
        }
    ]
}

In XML, the <demo> tag must be inside the </task> tag.

<task>
 	<demo>1</demo> 
	<domain>
		<name>example.com</name>
		<ctid>12345</ctid>
		<ownerc>ownerc</ownerc>
		<adminc>adminc</adminc>
		<techc>techc</techc>
		<zonec>zonec</zonec>
		<nserver>
			<name>ns1.example.com</name>
		</nserver>
		<nserver>
			<name>ns2.example.com</name>
		</nserver>
		<!-- optional. mandatory for some tlds -->
		<confirm_order>1</confirm_order>
		<!-- optional for some tlds -->
		<!--  <use_trustee>1</use_trustee> -->
		<!-- <use_autodns_dnssec>true|false</use_autodns_dnssec> -->
	</domain>
	<reply_to>EMAIL</reply_to>
</task>

<response>
    <result>
        <data>
            <domain_job>
                <job>
                    <id>4295210866</id>
                    <status>RUNNING</status>
                </job>
            </domain_job>
        </data>
        <msg>
            <text>Demo mode activated.</text>
            <code>MSG00001</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>