- Home
- API reference
- General API basics
- AutoDNS messages
- Notification examples
Domain contact job notifications
Contact created successfully
{
"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"
}
]
}<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
{
"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"
}
}<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
{
"stid": "20220405-app3-dev-6872",
"status": {
"code": "S0302",
"text": "Domain contact has been updated successfully.",
"type": "SUCCESS"
},
"object": {
"type": "Contact",
"value": "23377983"
}
}<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
{
"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"
}
}<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
{
"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
}
}
}
}
]
}<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>