Suche in diesem Bereich

Skip to end of metadata
Go to start of metadata
Inhaltsverzeichnis dieser Seite

Allgemein

Aynchrone Benachrichtigungen, informieren über den Status eines Auftrages. Sie werden zeitverzögert versendet, darum heißen sie asynchron, da andere Instanzen wie z. B. Registrys in die Verarbeitung des Prozesses involviert sind.
Das System versendet zwei Arten asynchroner Antwort-Typen: 

  • Auftragsbenachrichtigungen und

Auftragsbenachrichtigungen sind Antworten des Systems, die mit einem Auftrag zusammenhängen, der an das System gesendet wurde. Das System sendet bei einem eingehenden Auftrag in Echtzeit (synchron) sofort eine Systemantwort (Response) mit dem Statustyp notify, die den Start der Verarbeitung meldet.
Nach der Verarbeitung des Auftrages sendet das System entsprechend zeitverzögert eine Auftragsbenachrichtigung mit dem endgültigen Status des Auftrages, der entweder success  bei erfolgreicher oder failed  bei einer fehlgeschlagenen Verarbeitung sein kann.

Ereignisbenachrichtigungen sind Benachrichtigungen, die durch externe Ereignisse, wie z. B. einem ausgehenden Transfer oder einer Inhaber-Validierung ausgelöst werden Ereignisbenachrichtigungen werden an den Besitzer des Objektes gesendet. Es gibt verschiedene Ereignisse im System die eine Benachrichtigung auslösen können.

TransferOut

transfer_start

Start eines ausgehenden Domaintransfers. XML-Beispiel

transfer_autoack

Automatische Bestätigung eines ausgehende Transfers einer Domain (AutoAck). Nur für gTLDs. XML-Beispiel

transfer_autonack

Automatische Ablehnung eines ausgehende Transfers einer Domain (AutoNack). XML-Beispiel

transfer_reminder

Erinnerung an einen laufenden Transfer. XML-Beispiel

domain_away

Löschung einer Domain aus dem Bestand, z. B. bei Domain-Tansfers ohne Beteiligung des Registrars. XML-Beispiel

DomainAutoUpdate

autoupdate_dns_error

Erfolgreiche Ausführung einer automatischen Aktualisierung.
Nur bei .de-Domains. Eine automatische Aktualisierung wird nur durchgeführt, wenn die Konnektivitätsprüfung, die ein Teil des Registrierungsprozesses ist, fehlgeschlagen ist. XML-Beispiel

autoupdate_dns_success

Erfolgreiche Konnektivitätsprüfung. XML-Beispiel

autoupdate_deferred_success

Erfolgreiches nachgelagters AutoUpdate. XML-Beispiel

autoupdate_deferred_error

Fehlgeschlagenes nachgelagters AutoUpdate. XML-Beispiel

OCVAL (OwnerC-Validierung)

ocval_reminder

Erinnerung an die Abschaltung der Domain (5 Tage vorher). XML-Beispiel

ocval_deactivation

Information über die Dekonnektierung der Nameserver und die Nicht-Erreichbarkeit der Domain. XML-Beispiel

ocval_reactivation

Information über die Rekonnektierung der Nameserver und die Wieder-Erreichbarkeit der Domain. XML-Beispiel

Konfiguration in der Benutzeroberfläche

Die Benachrichtigungen werden über die AutoDNS Benutzeroberfläche konfiguriert (Benutzereinstellungen → Benutzerprofil → API-Einstellungen).

Konfiguration für E-Mail

Für E-Mail können drei verschiedene Benachrichtigungsformate festgelegt werden:

  • Standard : Der Inhalt besteht aus Text und XML.
  • XML : Der Inhalt besteht aus reinem XML.
  • JSON : DerInhalt besteht aus reinem JSON.

Konfiguration für Polling

Für Polling können drei verschiedene Benachrichtigungsformate festgelegt werden.
Das eingestellte Benachrichtigungsformat wird verwendet, sofern die Nachricht nicht abgeholt wird und vom System per E-Mail verschickt wird.

  • XML: Der Inhalt besteht aus reinem XML.
  • JSON: DerInhalt besteht aus reinem JSON.
  • EPP: Der Inhalt besteht aus reinem EPP XML ( Wird automatisch eingestellt sobald EPP-API aktiviert ist ).

Konfiguration für Push

Für Push können zwei verschiedene Benachrichtigungsformate festgelegt werden.
Das eingestellte Benachrichtigungsformat wird verwendet, sofern die Nachricht nicht abgeholt wird und vom System per E-Mail verschickt wird.

  • XML: Der Inhalt besteht aus reinem XML.
  • JSON: Der Inhalt besteht aus reinem JSON.

Bitte beachte, dass Push-Nachrichten über eine E-Mail-Weiterleitung nicht zugestellt werden können.

Konfiguration für Unterbenutzer-Benachrichtigungen (Parent Notify)

Informiert den Benutzer über die Aktionen seiner Unterbenutzer, indem es ihm Kopien aller Benachrichtigungen sendet, die das System an seine Unterbenutzer sendet. Sollte die Zustellung der Polling- oder Push-Zustellungsmethode nicht möglich sein, können Sie eine Ausweich-E-Mail-Adresse festlegen.

Konfiguration für Bereinigungs-Benachrichtigungen

Aufgrund der DSGVO werden nicht mehr genutzte Domain-Kontakte automatisch nach 6 Monaten gelöscht. Sie können hier System-Benachrichtigungen für diese Kontakt-Löschungen aktivieren. Zukünftig kann die Funktion auch für die Bereinigung anderer ungenutzter Objekte wie Zonen oder Weiterleitungen aktiviert werden.


Polling

Polling ist das aktive Abrufen von Systembenachrichtigungen durch den Benutzer. Die Benachrichtigungen liegen im strukturierten Format vor und werden nach dem FIFO-Prinzip verarbeitet.

Benachrichtigungen abrufen

  • JSON: Die aktuelle Systemmeldung kann über die GET /poll-Route abgerufen werden.
  • XML: Die aktuelle Systemmeldung kann über den Auftragstyp 0905 abgerufen werden.
  • EPP: Wenn EPP aktiviert ist, wird der Benutzer automatisch auf Polling eingestellt.

Beispiel für JSON, XML und EPP

Request
GET /poll
Response
{
    "stid": "20210505-app4-106167",
    "status": {
        "code": "S0905",
        "text": "Die Benachrichtigung wurde erfolgreich abgerufen.",
        "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>Die Benachrichtigung wurde erfolgreich abgerufen.</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>

Benachrichtigungen bestätigen

JSON: Eine Systemmeldung kann über die Route PUT /poll/{id} bestätigt werden. Die ID kann der Benachrichtigung entnommen werden.

XML: Eine bestimmte Systemmeldung kann mit der Aufgabe 0906 bestätigt werden. Die ID kann der Benachrichtigung entnommen werden.

  • Benachrichtigungen gelten als "erfolgreich zugestellt" wenn diese durch den Benutzer bestätigt wurden.
  • Wird eine Benachrichtigung nicht innerhalb von 24 Stunden durch den Benutzer bestätigt, erfolgt die Zustellung auf die Fallback-E-Mail (reply_to aus dem Request).

Beispiel für JSON, XML und EPP

Request
PUT /poll/{id}
Response
{
    "stid": "20180926-stid",
    "status": {
        "code": "S0906",
        "text": "Die Benachrichtigung wurde erfolgreich bestätigt.",
        "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>Die Benachrichtigung wurde erfolgreich bestätigt.</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)

Bei Push werden die Benachrichtigungen durch das System an eine angegebene Adresse (URL)  per HTTPS versendet.

Das Ziel kann die Systembenachrichtigungen aus dem HTTP Request Body auslesen und muss  mit einem HTTP 200 OK bestätigen.

Zieladressen

Die Nachrichten werden, via POST an die HTTPS-Zieladresse versendet.

Redirect werden NICHT weitergefolgt.

Benachrichtigungen bestätigen

Benachrichtigungen gelten als "erfolgreich zugestellt" wenn der Server als Antwort einen HTTP Status 200 sendet.
Kann eine Benachrichtigung nicht innerhalb von 24 Stunden zugesendet werden, erfolgt die Zustellung auf die Fallback-E-Mail (reply_to aus dem Request).

Quelladresse der Push-Benachrichtigungen

Die SourceIP ist 62.116.129.216. Konfiguriere deine Firewall entsprechend, damit die Push-Benachrichtigungen nicht herausgefiltert werden.

Beispiel für ein PHP-Skript zum Schreiben der Push-Meldung in eine Textdatei

Dieses Skript verarbeitet die Push-Meldung und schreibt diese in die Datei output.txt.  Hinterlege die URL, unter der dieses Script erreichbar ist, im Benutzerprofil unter den API-Einstellungen.

<?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);
?>

E-Mail

Benachrichtigungen werden per E-Mail versendet (Standardeinstellung).