Domain contact job notifications

Table of contents

Contact created successfully

JSON

{
    "stid": "20220405-app2-dev-82599",
    "status": {
        "code": "S0301",
        "text": "Domain-Kontakt wurde erfolgreich angelegt.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    },
    "data": [
        {
            "created": "2022-04-05T10:57:17.000+0200",
            "updated": "2022-04-05T10:57:17.000+0200",
            "id": 23377983,
            "owner": {
                "context": 4,
                "user": "exampleuser"
            },
            "updater": {
                "context": 4,
                "user": "exampleuser"
            },
            "alias": "John-Doe-12xx5678",
            "type": "PERSON",
            "organization": "CompanyExample",
            "title": "Dr.",
            "city": "Anytown",
            "country": "DE",
            "state": "BY",
            "email": "john.doe@domain.com",
            "protection": "SHOW_NONE",
            "remarks": [
                "example remark"
            ],
            "domainsafe": false,
            "lname": "Examplelastname",
            "address": [
                "2500 Example Street"
            ],
            "pcode": "12345"
        }
    ]
}

XML

<response>
	<result>
		<data>
			<summary>2</summary>
			<message>
				<id>21684</id>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<job>
					<handle>
						<type>PERSON</type>
						<fname>Peter</fname>
						<lname>Muster</lname>
						<title></title>
						<organization>PDA</organization>
						<address>Musterstrasse</address>
						<pcode>12345</pcode>
						<city>Musterstadt</city>
						<state></state>
						<country>Deutschland</country>
						<phone>+1-12345-12345</phone>
						<fax>+1-12345-12345</fax>
						<email>Muster@example.com</email>
						<protection>B</protection>
						<remarks></remarks>
						<extension/>
						<owner>
							<user>customer</user>
							<context>4</context>
						</owner>
						<id>10465849</id>
						<created>2011-05-30 14:40:52</created>
					</handle>
					<status>
						<text>Domain contact has been successfully created.</text>
						<code>S0301</code>
						<type>success</type>
						<object>
							<type>handle</type>
							<value>10465849</value>
						</object>
					</status>
					<ctid>448</ctid>
				</job>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20110530-app1-test-1283</stid>
</response>

Creating contact failed

JSON

{
    "stid": "20220405-app3-dev-6802",
    "messages": [
        {
            "text": "A domain contact with this name already exists.",
            "objects": [
                {
                    "type": "alias",
                    "value": "John-Doe-12xx5678"
                }
            ],
            "code": "EF03027",
            "status": "ERROR"
        }
    ],
    "status": {
        "code": "E0301",
        "text": "Domain contact could not be created.",
        "type": "ERROR"
    }
}

XML

<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<id>2166684</id>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<job>
					<handle>
						<type>PERSON</type>
						<fname>Peter</fname>
						<lname>Muster</lname>
						<title></title>
						<organization>PDA</organization>
						<address>Musterstrasse</address>
						<pcode>12345</pcode>
						<city>Musterstadt</city>
						<state></state>
						<country>Deutschland</country>
						<phone>+1-12345-12345</phone>
						<fax>+1-12345-12345</fax>
						<email>Muster@example.com</email>
						<sip></sip>
						<protection>B</protection>
						<nic_ref>de</nic_ref>
						<nic_ref>com</nic_ref>
						<nic_ref>net</nic_ref>
						<remarks></remarks>
					</handle>
					<nic_response></nic_response>
					<status>
						<text>Domain contact could not be created.</text>
						<code>E0301</code>
						<type>error</type>
						<object>
							<type>handle</type>
							<value>10544500</value>
						</object>
					</status>
					<ctid>qa-96123-2360</ctid>
				</job>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20111102-app1-test-52285</stid>
</response>

Contact updated successfully

JSON

{
    "stid": "20220405-app3-dev-6872",
    "status": {
        "code": "S0302",
        "text": "Domain contact has been updated successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    }
}

XML

<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<id>21797</id>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<job>
					<handle>
						<type>PERSON</type>
						<fname>Peter</fname>
						<lname>Muster</lname>
						<title></title>
						<organization>PDA</organization>
						<address>Musterstrasse</address>
						<pcode>12345</pcode>
						<city>Musterstadt</city>
						<state></state>
						<country>Deutschland</country>
						<phone>+1-12345-12345</phone>
						<fax>+1-12345-12345</fax>
						<email>Muster@example.com</email>
						<protection>B</protection>
						<remarks></remarks>
						<nic_ref>
							<type>ALL</type>
							<role>ALL</role>
							<nic>...</nic>
							<status>success</status>
							<name></name>
						</nic_ref>
						<extension/>
						<owner>
							<user>customer</user>
							<context>4</context>
						</owner>
						<id>10465897</id>
						<created>2011-06-01 12:41:53</created>
					</handle>
					<status>
						<text>Domain contact has been updated successfully.</text>
						<code>S0302</code>
						<type>success</type>
						<object>
							<type>handle</type>
							<value>10465897</value>
						</object>
					</status>
					<ctid>2223</ctid>
				</job>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20110601-app1-test-44868</stid>
</response>

Contact update failed

JSON

{
    "stid": "20220405-app2-dev-84784",
    "messages": [
        {
            "text": "Last name may not be changed by an update.",
            "objects": [
                {
                    "type": "string",
                    "value": "Examplelastname"
                }
            ],
            "code": "EF00559",
            "status": "ERROR"
        }
    ],
    "status": {
        "code": "E0302",
        "text": "Domain contact could not be updated.",
        "type": "ERROR"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    }
}

XML

<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<id>21802</id>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<job>
					<handle>
						<type>PERSON</type>
						<fname>Peter</fname>
						<lname>Muster</lname>
						<title></title>
						<organization>PDA</organization>
						<address>Musterstrasse</address>
						<pcode>12345</pcode>
						<city>Musterstadt</city>
						<state></state>
						<country>Deutschland</country>
						<phone>+1-12345-12345</phone>
						<fax>+1-12345-12345</fax>
						<email>Muster@example.com</email>
						<sip></sip>
						<email>customer@example.com</email>
						<protection>B</protection>
						<remarks></remarks>
						<nic_ref>
							<type>ALL</type>
							<role>ALL</role>
							<nic>de</nic>
							<status>failed</status>
							<name></name>
						</nic_ref>
						<extension/>
						<owner>
							<user>customer</user>
							<context>4</context>
						</owner>
						<id>10465899</id>
						<created>2011-06-01 14:29:01</created>
					</handle>
					<nic_response></nic_response>
					<status>
						<text>Domain contact could not be updated.</text>
						<code>E0302</code>
						<type>error</type>
						<object>
							<type>handle</type>
							<value>10465899</value>
						</object>
					</status>
					<ctid>2223</ctid>
				</job>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20110601-app1-test-44949</stid>
</response>

Contact deleted successfully

Domain contacts that have not been used for 12 months are automatically deleted by a cronjob.

The sending of notifications must be set up in AutoDNS. To do this, the Purge Notifications checkbox must be enabled in the user profile. (User Management → User Profile → API Settings → System Notifications ).

The contact must not be in use for a domain or in a running job.

In case of failure, no notification is sent, because in this case the order is rejected by the backend and thus not processed.

Example for push notifications

JSON

{
  "stid": "20220610-app4-226953",
  "status": {
    "code": "S0905",
    "text": "The notification was polled successfully.",
    "type": "SUCCESS"
  },
  "object": {
    "type": "Message",
    "value": "64774886",
    "summary": 1
  },
  "data": [
    {
      "id": 64774886,
      "notify": {
        "type": "contact_deleted",
        "object": {
          "type": "Contact",
          "data": {
            "id": 12345
          }
        }
      }
    }
  ]
}

XML

<response>
	<result>
		<data>
			<summary>1</summary>     
			<message>
				<handle>
					<id>23308053</id>
				</handle>
				<type>contact_deleted</type>
				<msg>
					<code>MSG01039</code>
					<type>notice</type>
				</msg>
				<status>
					<code>S0303</code>
					<type>success</type>
				</status>
				<id>1005452585</id>
				<created>2021-05-11 10:53:21</created>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
			<object>
				<type>message</type>
				<value>1005420303</value>
			</object>
		</status>
	</result>
	<stid>20210510-app3-dev-9688</stid>
</response>