Inhaltsverzeichnis dieser Seite

Für das Abrufen der Benachrichtigungen aus der Warteschlange stehen die Methoden Polling, Push und E-Mail zur Verfügung.

Polling

Polling ist das aktive Abrufen von Systembenachrichtigungen aus der Warteschlange durch den Benutzer. Die Benachrichtigungen liegen im strukturierten Format vor und werden nach dem FIFO-Prinzip verarbeitet.
Das Abrufen wird in zwei Schritten ausgeführt: die jeweils letze Nachricht wird abgerufen und der Abruf wird dann bestätigt.

Benachrichtigungen abrufen

  • JSON: Die aktuelle Systembenachrichtigung kann über die GET /poll-Route abgerufen werden.
  • XML: Die aktuelle Systembenachrichtigung kann über den Auftragstyp 0905 PollInfo abgerufen werden.
  • EPP: Wenn EPP aktiviert ist, wird für den Benutzer automatisch 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 
<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 Systembenachrichtigung muss über die Route PUT /poll/{id} bestätigt werden. Die ID kann der Benachrichtigung entnommen werden.
  • XML: Eine bestimmte Systembenachrichtigung muss mit dem Auftragstyp 0906 PollConfirm 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 Systembenachrichtigung werden via POST an die HTTPS-Zieladresse versendet.

Weiterleitungen 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-Benachrichtigungen

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).