- Start
- API-Referenz
- Allgemeine API-Grundlagen
- Nachrichten im AutoDNS
- Beispiele für Benachrichtigungen
Benachrichtigungen bei Kontakt-Aufträgen
Kontakt erfolgreich angelegt
{
"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-Kontakt wurde erfolgreich angelegt.</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>Die Benachrichtigung wurde erfolgreich abgerufen.</text>
<type>success</type>
</status>
</result>
<stid>20110530-app1-test-1283</stid>
</response>
Kontakt anlegen fehlgeschlagen
{
"stid": "20220405-app3-dev-6802",
"messages": [
{
"text": "Es ist bereits eine Domain-Kontakt mit diesem Namen vorhanden.",
"objects": [
{
"type": "alias",
"value": "John-Doe-12xx5678"
}
],
"code": "EF03027",
"status": "ERROR"
}
],
"status": {
"code": "E0301",
"text": "Domain-Kontakt konnte nicht angelegt werden.",
"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-Kontakt konnte nicht angelegt werden.</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>Die Benachrichtigung wurde erfolgreich abgerufen.</text>
<type>success</type>
</status>
</result>
<stid>20111102-app1-test-52285</stid>
</response>
Kontakt erfolgreich aktualisiert
{
"stid": "20220405-app3-dev-6872",
"status": {
"code": "S0302",
"text": "Domain-Kontakt wurde erfolgreich aktualisiert.",
"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-Kontakt wurde erfolgreich aktualisiert.</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>Die Benachrichtigung wurde erfolgreich abgerufen.</text>
<type>success</type>
</status>
</result>
<stid>20110601-app1-test-44868</stid>
</response>
Kontakt aktualisieren fehlgeschlagen
{
"stid": "20220405-app2-dev-84784",
"messages": [
{
"text": "Nachname darf nicht geändert werden.",
"objects": [
{
"type": "string",
"value": "Examplelastname"
}
],
"code": "EF00559",
"status": "ERROR"
}
],
"status": {
"code": "E0302",
"text": "Domain-Kontakt konnte nicht aktualisiert werden.",
"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-Kontakt konnte nicht aktualisiert werden.</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>Die Benachrichtigung wurde erfolgreich abgerufen.</text>
<type>success</type>
</status>
</result>
<stid>20110601-app1-test-44949</stid>
</response>
Kontakt erfolgreich gelöscht
Domain-Kontakte, die seit 12 Monaten nicht mehr verwendet werden, werden automatisch durch einen Cronjob gelöscht.
Das Versenden der Benachrichtigungen muss im AutoDNS eingerichtet werden. Dafür muss im Benutzerprofil die Checkbox bei Bereinigungs-Benachichtigungen aktiviert werden (Benutzerverwaltung --> Benutzereinstellungen -->Benutzerprofil → API-Einstellungen → Systembenachrichtigungen)
Der Kontakt darf nicht für eine Domain oder in einem laufenden Auftrag in Verwendung sein.
Beim Fehlschlagen wird keine Benachrichtigung vesendet, da in diesem Fall der Auftrag vom Backend abgelehnt und damit nicht verarbeitet wird.
{
"stid": "20220610-app4-226953",
"status": {
"code": "S0905",
"text": "Die Benachrichtigung wurde erfolgreich abgerufen.",
"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>Die Benachrichtigung wurde erfolgreich abgerufen.</text>
<type>success</type>
<object>
<type>message</type>
<value>1005420303</value>
</object>
</status>
</result>
<stid>20210510-app3-dev-9688</stid>
</response>