Suche in diesem Bereich

Skip to end of metadata
Go to start of metadata


Table of Contents

General

Asynchronous notifications inform you of the status of an order. They are sent with a time delay, that's why they are called asynchronous, because other entities such as registries are involved in the processing of the process. The system sends two types of asynchronous response types: 

  • Job notifications and
  • Event notifications

Job Notifications

Job notifications are system responses related to an request sent to the system. For an incoming request, the system immediately sends a system response in real time with the status type notify, which reports the start of processing. After processing the job, the system sends an job notification with the final job status, which can be either success on successful processing or error on failed processing.

Event Notifications (Notifies)

Event notifications are notifications that are triggered by external events, such as an outgoing transfer or owner validation. Event notifications are sent to the owner of the object.

TransferOut

transfer_start

Start of an outgoing domain transfer. XML Example

transfer_autoack

Automatic confirmation of an outgoing domain transfer (AutoAck). Only for gTLDs. XML Example

transfer_autonack

Automatic refusal of an outgoing transfer (AutoNack). XML Example

transfer_reminder

Reminder of an ongoing transfer. XML Example

domain_away

Deletion of a domain from the database, e.g. in the case of domain transfers without the participation of the registrar. XML Example

DomainAutoUpdate

autoupdate_dns_error

Successful execution of an automatic update. Only for .de domains. An automatic update is only performed if the connectivity check, which is part of the registration process, has failed. XML Example

autoupdate_dns_success

Successful connectivity check. XML Example

autoupdate_deferred_success

Successful deferred AutoUpdate. XML Example

autoupdate_deferred_error

Failed deferred AutoUpdate. XML Example

OCVAL (OwnerC validation)

ocval_reminder

Reminder to deactivate the domain (5 days before). XML Example

ocval_activation

Information about the disconnection of the name servers and the non-accessibility of the domain. XML Example

ocval_deactivation

Information about the reconnection of the nameservers and the re-accessibility of the domain. XML Example

Configuration in the Interface

The notifications can be configured in the AutoDNS interface (User Settings / User Profile / API Settings).

Configuration for Emails

For Email three different notification formats can be defined:
  • Standard: The content consists of text and XML.
  • XML: The content consists of pure XML.
  • JSON: The content is pure JSON.


Configuration for Polling

Three different notification formats can be defined for Polling. The set format is used if the message is not retrieved and is sent by the system via email.
  • XML: The content consists of pure XML.
  • JSON: The content consists of pure JSON.
  • EPP: The content consists of pure EPP (will be set automatically as soon as EPP API is activated).

Configuration for Push

Two different notification formats can be defined for Push. The set format is used if the message is not retrieved and is sent by the system via email.   

  • XML: The content consists of pure XML.
  • JSON: The content consists of pure JSON.



Please note that push messages cannot be delivered via e-mail forwarding.

Configuration for Parent Notify

Informs the user about the transactions of his subusers by sending him copies of all notifications that the system sends to his subusers via the selected delivery method. Should the delivery of the poll or push delivery method not be possible, you can set a fallback email address.

Configuration for Purge Notifications

Due to GDPR, domain contacts that are no longer used are automatically deleted after 6 months.You can activate system notifications for these contact deletions here. In the future, the function can also be used for purging other unused objects like zones or redirects.

Polling

Polling is the active retrieval of system notifications by the user. The notifications are available in structured format and are processed according to the FIFO principle.

Get Notifications

JSON: The current system notification can be retrieved via the GET /poll route.XML: The current system notification can be retrieved via the task 0905.EPP: If EPP is activated, the user is automatically set to polling.

Examples  for JSON, XML and EPP

Request
GET /poll
Response
{
    "stid": "20210505-app4-106167",
    "status": {
        "code": "S0905",
        "text": "The notification was polled successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Message",
        "value": "51646140",
        "summary": 1
    },
    "data": [
        {
            "id": 51646140,
            "job": {
                "created": "2021-05-05T10:22:04.000+0200",
                "updated": "2021-05-05T10:22:12.000+0200",
                "status": "SUCCESS",
                "execution": "2021-05-05T10:22:04.000+0200",
                "subType": "BASIC_SSL",
                "action": "create",
                "id": 28983240
            },
            "stid": "20210505-app1-102766",
            "object": {
                "type": "Certificate",
                "value": "domain.de",
                "data": {
                    "created": "2021-05-05T00:00:00.000+0200",
                    "updated": "2021-05-05T10:22:12.000+0200",
                    "id": 2452924,
                    "partnerOrderId": "IX-CC-28983240",
                    "orderId": "033328606",
                    "adminContact": {
                        "id": -1
                    },
                    "technicalContact": {
                        "fname": "Max",
                        "lname": "Mustermann",
                        "phone": "+49-941-59559463",
                        "fax": "+49-941-59559463",
                        "email": "max.mustermann@internetx.com",
                        "title": "Admin",
                        "organization": "InterNetX GmbH",
                        "address": [
                            "Johanna-Dachs-Str. 55"
                        ],
                        "pcode": "93055",
                        "city": "Regensburg",
                        "country": "DE",
                        "state": "BY",
                        "id": 30176
                    },
                    "name": "domain.de",
                    "lifetime": {
                        "unit": "MONTH",
                        "period": 12
                    },
                    "software": "APACHE2",
                    "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwdzELMAkGA1UEBhMCREUxCzAJBgNVBAgMAkJZMRMwEQYDVQQH\nDApSZWdlbnNidXJnMRcwFQYDVQQKDA5JbnRlck5ldFggR21iSDEUMBIGA1UECwwL\nRW50d2lja2x1bmcxFzAVBgNVBAMMDmp1bmtkcmFnb25zLmRlMIIBIjANBgkqhkiG\n9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzgUABWcrarE++2bCqLJMtuSq5Z3okflkLtw8\ngwHP6+7KM50ltNWhZUf/R++2kbpO8AXQA5wsO/vb5QDDgxJAmbBIzDxvQrirKNwF\naQJPVNlolJI13YvFsSQ7YWn3vxjBIQW+qlL8YNjfizea5qiwM6FCIJ5aY8q3+RaP\nCNWR5XAZGEKwdSTAweAEBp5GzwjZ72zx3+dSpKj20Ji+VeYS0nYvuQX3YRzViY/M\nwhmtEJS9zr7JonvJDyh6EuTHgqmQVz+dC9SoZcQC5MQCwBMYvOVB4L5Ah4bCZWNp\n5ufCljVCExjjj6hgTYVQHTo2jrkT6NVtwM1hG7D3VjzbIVre8QIDAQABoAAwDQYJ\nKoZIhvcNAQELBQADggEBAEdP4jPioxnx4q9XDCk0GBZEIAGvasuz6vE5ezlzcGt9\nVsUlZKdxdAA6dVXyajIaGRgO5fniJEn3o+uUjAHhY7lnav91g9cnEx41QDYwmM+F\nkpoyj26j6PYHITXv4skT2vgahnP6K4Bz5sACLchzBJ1VvXeGp1AZmtq7rwNkD49l\nLE9J9tvhjSTo3gz9EY4YbrkGj56RRx7RMYNE7kRgEYznRjbSESeF9KMOxHiLKMxf\nMEDgFhTdHTSG67d3pdyC25XO3IJivSmcBHlYje6doapjqyRXrxXfYWU965sgOV+Q\n3LvEP1hIWOJj1uQhH42XpU0jm9vhh8jC9r7WSACuPYk=\n-----END CERTIFICATE REQUEST-----",
                    "server": "-----BEGIN CERTIFICATE-----\nMIIGBDCCBOygAwIBAgIQAexg7sxHPhooDFCMKrM3vTANBgkqhkiG9w0BAQsFADBu\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\nd3cuZGlnaWNlcnQuY29tMS0wKwYDVQQDEyRFbmNyeXB0aW9uIEV2ZXJ5d2hlcmUg\nRFYgVExTIENBIC0gRzEwHhcNMjEwNTA1MDAwMDAwWhcNMjIwNTA1MjM1OTU5WjAZ\nMRcwFQYDVQQDEw5qdW5rZHJhZ29ucy5kZTCCASIwDQYJKoZIhvcNAQEBBQADggEP\nADCCAQoCggEBAM4FAAVnK2qxPvtmwqiyTLbkquWd6JH5ZC7cPIMBz+vuyjOdJbTV\noWVH/0fvtpG6TvAF0AORszv72+UAw4MSQJmwSMw8b0K4qyjcBWkCT1TZaJSSNd2L\nxbEkO2Fp978YwSEFvqpS/GDY34s3muaosDOhQiCeWmPKt/kWjwjVkeVwGRhCsHUk\nwMHgBAaeRs8I2e9s8d/nUqSo9tCYvlXmEtJ2L7kF92Ec1YmPzMIZrRCUvc6+yaJ7\nyQ8oehLkx4KpkFc/nQvUqGXEAuTEAsATGLzlQeC+QIeGwmVjaebnwpY1QhMY44+o\nYE2FUB06No65E+jVbcDNYRuw91Y82yFa3vECAwEAAaOCAvEwggLtMB8GA1UdIwQY\nMBaAFFV0T7JyT/VgulDR1+ZRXJoBhxrXMB0GA1UdDgQWBBRXyIeOmajF8etYxeQM\nLcsfUQ5YpTAtBgNVHREEJjAkgg5qdW5rZHJhZ29ucy5kZYISd3d3Lmp1bmtkcmFn\nb25zLmRlMA4GA1UdDwEB/wQEAwIFoDAdBgNVHSUEFjAUBggrBgEeBQcDAQYIKwYB\nBQUHAwIwPgYDVR0gBDcwNTAzBgZngQwBAgEwKTAnBggrBgEFBQcCARYbaHR0cDov\nL3d3dy5kaWdpY2VydC5jb20vQ1BTMIGABggrBgEFBQcBAQR0MHIwJAYIKwYBBQUH\nMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBKBggewgEFBQcwAoY+aHR0cDov\nL2NhY2VydHMuZGlnaWNlcnQuY29tL0VuY3J5cHRpb25FdmVyeXdoZXJlRFZUTFND\nQS1HMS5jcnQwCQYDVR0TBAIwADCCAX0GCisGAQQB1nkCBAIEggFtBIIBaQFnAHYA\nKXm+8J45OSHwVnOfY6V35b5XfZxgCvj5TV0mXCVdx4QAAAF5O57AIQAABAMARzBF\nAiEA4hM/fAE7YznaYj7md1NphwBXPWvAtKsdSR7IEsWBW7cCIA3P8V2D0/0F4YDP\ntm9XMLXpDLkgG5c/hQ5j0UH0Q4DXAHYAIkVFB1lVJFaWP6Ev8fdthuAjJmOtwEt/\nXcaDXG7iDwIAAAF5O57AXwAABAMARzBFAiBnSs0Ho3P06bgGj//GqBfR+py91O/t\napFmOt0BysQ8oAIhAJuGQHji/A+2xXYv8B57XydDyeUgthe3RUf5mK8+d9+bAHUA\nUaOw9f0BeZxWbbg3eI8MpHrMGyfL956IQpoN/tSLBeUAAAF5O56+sAAABAMARjBE\nAiAn5OYBibR9/ZXkQU+ERPyTR/JiYSun/ZV0G9nQgc9drwIgATNi2YE8YR/V6EWf\nLCdaoN5uambdalpjD76etECrSI4wDQYJKoZIhvcNAQELBQADggEBAH6p0o8Byyew\naZxfx61UBGqOczMP6dWa0e6jRX8xoCWo2071CEBbMgvHvqywF4weTqVD6CwG7srP\ne4j1xmXLWTqBQtf6xxfgv/CxHUO37s+011sERqsAvLbhpslWw74sLJ9Bim575Sf3\n0aAgz7hJpZjgv3+LV4puwI7u0zmjE+9rv7Ml3yoneQMNMd8mVaAhAiBmYbApujsT\nJ8bdmtKDG7q5Z2Xou3cUqNlR1sr2wDIAJjjr0fqtox7+zE/tWfPmfe0RlognYuSe\npRSYvRBTggKwylmbohS6VrlJMq2nTiZb1hoHfoGNJ2YiKyW2+xfQlEdY0+YPzePa\nTf2eRsOJIf8=\n-----END CERTIFICATE-----",
                    "serialNumber": "01EC60EBBC473E1A280C508C2AB337BD",
                    "product": "BASIC_SSL",
                    "signatureHashAlgorithm": "SHA2",
                    "expire": "2022-05-06T01:59:59.000+0200",
                    "payable": "2022-05-05T00:00:00.000+0200",
                    "extension": {},
                    "certificationAuthority": [
                        {
                            "caType": "INTERMEDIATE",
                            "caCertificate": "-----BEGIN CERTIFICATE-----\nMIIEqjCCA5KgAwIBAgIQAnmsRYvBskWr+YBTzSybsTANBgkqhkiG9w0BAQsFADBh\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\nd3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD\nQTAeFw0xNzExMjcxMjQ2MTBaFw0yNzExMjcxMjQ2MTBaMG4xCzAJBgNVBAYTAlVT\nMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j\nb20xLTArBgNVBAMTJEVuY3J5cHRpb24gRXZlcnl3aGVyZSBEViBUTFMgQ0EgLSBH\nMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALPeP6wkab41dyQh6mKc\noHqt3jRIxW5MDvf9QyiOR7VfFwK656es0UFiIa25a9pRntzF1UgYzDGu3ppZVMdo\nlbxhm6dWS9OK/lFehKNT0OYI9aqk6F+U7cA6jxSC+iDBPXwdF4rs3KRyp3aQn6pj\npp1yr7IB6Y4zv72Ee/PlZ/6rK6InC6WpK0nPVOYR7n9iDuPe1E4IxUMBH/T33+3h\nyuH3dvfgiWUOUkjdpMbyxX+XNle5uEIiyBsi4IvbcTCh8ruifCIi5mDXkZrnMT8n\nwfYCV6v6kDdXkbgGRLKsR4pucbJtbKqIkUGxuZI2t7pfewKRc5nWecvDBZf3+p1M\npA8CAwEAAaOCAU8wggFLMB0GA1UdDgQWBBRVdE+yck/1YLpQ0dfmUVyaAYca1zAf\nBgNVHSMEGDAWgBQD3lA1VtFMu2bwo+IbG8OXsj3RVTAOBgNVHQ8BAf8EBAMCAYYw\nHQYDVR0lBBYwFAYIKwYBBQUHAwEGCCsGAQUFBwMCMBIGA1UdEwEB/wQIMAYBAf8C\nAQAwNAYIKwYBBQUHAQEEKDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp\nY2VydC5jb20wQgYDVR0fBDswOTA3oDWgM4YxaHR0cDovL2NybDMuZGlnaWNlcnQu\nY29tL0RpZ2lDZXJ0R2xvYmFsUm9vdENBLmNybDBMBgNVHSAERTBDMDcGCWCGSAGG\n/WwBAjAqMCgGCCsGAQUFBwIBFhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BT\nMAgGBmeBDAECATANBgkqhkiG9w0BAQsFAAOCAQEAK3Gp6/aGq7aBZsxf/oQ+TD/B\nSwW3AU4ETK+GQf2kFzYZkby5SFrHdPomunx2HBzViUchGoofGgg7gHW0W3MlQAXW\nM0r5LUvStcr82QDWYNPaUy4taCQmyaJ+VB+6wxHstSigOlSNF2a6vg4rgexixeiV\n4YSB03Yqp2t3TeZHM9ESfkus74nQyW7pRGezj+TC44xCagCQQOzzNmzEAP2SnCrJ\nsNE2DpRVMnL8J6xBRdjmOsC3N6cQuKuRXbzByVBjCqAA8t1L0I+9wXJerLPyErjy\nrMKWaBFLmfK/AHNF4ZihwPGOc7w6UHczBZXH5RFzJNnww+WnKuTPI0HfnVH8lg==\n-----END CERTIFICATE-----"
                        },
                        {
                            "caType": "ROOT",
                            "caCertificate": "-----BEGIN CERTIFICATE-----\nMIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3\nd3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD\nQTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT\nMRUwEwYDVQQKEwxEAAdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j\nb20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG\n9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB\nCSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97\nnh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt\n43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P\nT19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4\ngdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO\nBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR\nTLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw\nDQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr\nhMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOBBkXDiqw8cvpOp/2PV5Adg\n06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF\nPnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls\nYSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk\nCAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=\n-----END CERTIFICATE-----"
                        }
                    ],
                    "authentication": {
                        "method": "DNS",
                        "dns": "_dnsauth.domain.de.\t300\tIN\tTXT\t\"202105050821384da655mdymr9p1y19scwx9lgt6s3daj1p7g1uzer3ydtmzcb6h\""
                    },
                    "certificateTransparencyPrivacy": "PUBLIC"
                }
            }
        }
    ]
}
Request
<request>
    <auth>
        <user>USER</user>
        <context>CONTEXT</context>
        <password>PASSWORD</password>
    </auth>
    <task>
        <code>0905</code>
    </task>
</request>
Response
<response>
    <result>
        <data>
            <summary>1</summary>
            <message>
                <id>1855680</id>
                <owner>
                    <user>alex_normal_plus</user>
                    <context>4</context>
                </owner>
                <job>
                    <domain>
                        <name>example.com</name>
                        <expire>2019-10-15 14:02:40</expire>
                        <payable>2019-10-15 14:02:41</payable>
                        <ownerc>100</ownerc>
                        <adminc>100</adminc>
                        <techc>100</techc>
                        <nic_member_label>VGRS-TEST</nic_member_label>
                        <registry_status>LOCK</registry_status>
                        <nserver>
                            <name>a.ns14.net</name>
                        </nserver>
                        <nserver>
                            <name>b.ns14.net</name>
                        </nserver>
                        <nserver>
                            <name>c.ns14.net</name>
                        </nserver>
                        <nserver>
                            <name>d.ns14.net</name>
                        </nserver>
                        <period>1</period>
                        <authinfo>S0Lygv+ZkNbniICm</authinfo>
                        <autorenew>true</autorenew>
                        <confirm_order>1</confirm_order>
                        <confirm_owner_consent>0</confirm_owner_consent>
                        <registrar_status>ACTIVE</registrar_status>
                        <rdds_opt_in>NOT_SET</rdds_opt_in>
                        <owner/>
                        <updater/>
                        <created>2018-10-15 14:02:41</created>
                    </domain>
                    <job_id>4295625406</job_id>
                    <status>
                        <code>S0101</code>
                        <type>success</type>
                        <object>
                            <type>domain</type>
                            <value>example.com</value>
                        </object>
                    </status>
                    <stid>20181015-app1-3788</stid>
                </job>
                <created>2018-10-15 14:03:02</created>
            </message>
        </data>
        <status>
            <code>S0905</code>
            <text>The notification was polled successfully.</text>
            <type>success</type>
            <object>
                <type>message</type>
                <value>1855680</value>
            </object>
        </status>
    </result>
    <stid>20181015-app1-3805</stid>
</response>
Request
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
	<command>
		<poll op="req" />
		<clTRID>ABC-12345</clTRID>
	</command>
</epp>
Reponse
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:domainrobot="urn:org:domainrobot:ns:ext-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:ro="urn:org:domainrobot:ns:contact:ro-1.0" xmlns:xxx="urn:org:domainrobot:ns:contact:xxx-1.0" xmlns:ca="urn:org:domainrobot:ns:contact:ca-1.0" xmlns:cat="urn:org:domainrobot:ns:contact:cat-1.0" xmlns:jobs="urn:org:domainrobot:ns:contact:jobs-1.0" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0" xmlns:aero="urn:org:domainrobot:ns:contact:aero-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:hk="urn:org:domainrobot:ns:contact:hk-1.0" xmlns:bank="urn:org:domainrobot:ns:contact:bank-1.0" xmlns:it="urn:org:domainrobot:ns:contact:it-1.0" xmlns:barcelona="urn:org:domainrobot:ns:contact:barcelona-1.0" xmlns:au="urn:org:domainrobot:ns:contact:au-1.0" xmlns:uk="urn:org:domainrobot:ns:contact:uk-1.0" xmlns:swiss="urn:org:domainrobot:ns:contact:swiss-1.0" xmlns:ru="urn:org:domainrobot:ns:contact:ru-1.0">
  <response>
    <result code="1301">
      <msg lang="en">Command completed successfully; ack to dequeue</msg>
    </result>
    <msgQ count="1" id="880369">
      <qDate>2017-07-14T13:46:33.000Z</qDate>
    </msgQ>
    <resData>
      <domain:panData>
        <domain:name paResult="1">domain.com</domain:name>
        <domain:paTRID>
          <clTRID>EXAMPLE-123456789</clTRID>
          <svTRID>20170731-app1-10001</svTRID>
        </domain:paTRID>
        <domain:paDate>2017-07-31T13:46:33.000Z</domain:paDate>
      </domain:panData>
      <domain:infData>
        <domain:name>domain.com</domain:name>
        <domain:registrant>23022508</domain:registrant>
        <domain:contact type="admin">23022508</domain:contact>
        <domain:contact type="tech">23022508</domain:contact>
        <domain:ns>
          <domain:hostAttr>
            <domain:hostName>c.ns14.net</domain:hostName>
          </domain:hostAttr>
          <domain:hostAttr>
            <domain:hostName>d.ns14.net</domain:hostName>
          </domain:hostAttr>
        </domain:ns>
        <domain:crDate>2017-07-14T13:46:23.000Z</domain:crDate>
        <domain:exDate>2019-07-14T13:46:23.000Z</domain:exDate>
        <domain:authInfo>
          <domain:pw>L14HY+jaa45odO0v</domain:pw>
        </domain:authInfo>
      </domain:infData>
    </resData>
    <extension>
      <domainrobot:domain>
        <domainrobot:zonec>23022508</domainrobot:zonec>
        <domainrobot:trustee>0</domainrobot:trustee>
        <domainrobot:privacy>0</domainrobot:privacy>
      </domainrobot:domain>
    </extension>
    <trID>
      <clTRID>a2d8e98e-c703-4368-a986-a1fdfa42b8fe</clTRID>
      <svTRID>12345678</svTRID>
    </trID>
  </response>
</epp>

Confirm Notifications

JSON: A specific system notification can be confirmed via the route PUT /poll/{id}. The ID can be taken from the notification.XML: A specific system notification can be confirmed with the task 0906. The ID can be taken from the notification.
  • Notifications are considered "successfully delivered" if they have been confirmed by the user.
  • If a notification is not confirmed by the user within 24 hours, it will be delivered to the fallback email (reply_to from the request).

Examples  for JSON, XML and EPP

Request
PUT /poll/{id}
Response
{
    "stid": "20180926-stid",
    "status": {
        "code": "S0906",
        "text": "The notification was confirmed successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "message",
        "value": "1819853"
    }
}
Request
<request>
    <auth>
        <user>USER</user>
        <context>CONTEXT</context>
        <password>PASSWORD</password>
    </auth>
    <task>
        <code>0906</code>
       <message>
            <id>650664</id>
        </message>
    </task>
</request>
Response
<response>
    <result>
        <data>
            <summary>0</summary>
            <message>
                <id>650664</id>
            </message>
        </data>
        <status>
            <code>S0906</code>
            <text>The notification was confirmed successfully.</text>
            <type>success</type>
            <object>
                <type>message</type>
                <value>650664</value>
            </object>
        </status>
         <stid>20181015-app1-3162</stid>
	 </result>
</response>
Request
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
	<command>
		<poll op="ack" msgID="627787" />
		<clTRID>ABC-12346</clTRID>
	</command>
</epp>
Reponse
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <response>
        <result code="1000">
            <msg lang="en">Command completed successfully</msg>
        </result>
        <msgQ count="0" id="627787" />
        <trID>
            <clTRID>ABC-12346</clTRID>
        </trID>
    </response>
</epp>

Push (Webhook)

Push is the passive retrieval of system notifications. The notifications are sent by the system to a specified address (URL) using HTTPS.The target can read the system notifications from the HTTP request body and must confirm receipt with an HTTP 200 OK.

Target adresses

The messages are sent via POST to the HTTPS destination address.
Redirect are NOT followed up.

Confirming Notifications

Notifications are considered as "successfully delivered" if the server sends an HTTP Status 200 response.
If a notification cannot be sent within 24 hours, it will be delivered to the fallback email address (reply_to from the request).

Source address of the push notifications

The source IP is 62.116.129.216. Configure your firewall accordingly so that the push notifications are not filtered out.

Example PHP script for writing the push message to a textfile

This script will process the PUSH Message and write it to output.txt.   Define this Script (URL+Script) In the user profile under the API settings.
<?php
// Helper methods
function getHeaderList() {
        $headerList = array();
        foreach ($_SERVER as $name => $value) {
                if (preg_match('/^HTTP_/',$name)) {
                        $name = strtr(substr($name,5),'_',' ');
                        $name = ucwords(strtolower($name));
                        $name = strtr($name,' ','-');
                        // add to list
                        $headerList[$name] = $value;
                 }
        }
    return $headerList;
}

// Variables
$file = "output.txt";

// Fetch headers
$headers = "";
foreach (getHeaderList() as $name => $value) {
   $headers .= $name . ': ' . $value . "\n";
}

// Fetch body
$body = file_get_contents('php://input');

// Fetch current date
$now = date('Y-m-d H:i:s', time());

$content = "Date: $now\nHeaders: $headers\nBody: $body\n---------------------------------------------------------------------------------\n";

// Write to file
file_put_contents($file, $content, FILE_APPEND);
?>

Email

Notifications are sent by email (default setting).