{"id":3128,"date":"2026-03-23T16:08:08","date_gmt":"2026-03-23T15:08:08","guid":{"rendered":"https:\/\/support.pt.lu\/?page_id=3128"},"modified":"2026-04-29T10:25:10","modified_gmt":"2026-04-29T09:25:10","slug":"api-documentation-mydomain-lu","status":"publish","type":"page","link":"https:\/\/support.pt.lu\/de\/api-documentation-mydomain-lu\/","title":{"rendered":"API-Dokumentation (mydomain.lu)"},"content":{"rendered":"<h2><b>API&#x2011;&#xDC;bersicht<\/b><\/h2>\n<p>Die <b>mydomain.lu DNS Management API<\/b> erm&#xF6;glicht die automatisierte Verwaltung von DNS&#x2011;Zonen. Sie bietet Funktionen zum Abrufen von Zonendaten, Exportieren von Zonendateien sowie zum Hinzuf&#xFC;gen, Aktualisieren oder Entfernen von DNS&#x2011;Eintr&#xE4;gen. Jede &#xC4;nderung erzeugt ein <b>Ticket<\/b>, da DNS&#x2011;Modifikationen asynchron verarbeitet werden.<br>\nEine Bestellung wird nacheinander verarbeitet. Du musst warten, bis die aktuelle Bestellung abgeschlossen ist, bevor du eine neue einreichst. Wenn du nicht wartest, schl&#xE4;gt die Bestellung fehl. Bitte warte ein paar Sekunden, bis die Bestellung abgeschlossen und &#xFC;bernommen wurde.<\/p>\n<hr>\n<h2><b>Voraussetzungen<\/b><\/h2>\n<ul>\n<li>Sie m&#xFC;ssen <b>Kunde von mydomain.lu<\/b> sein.<\/li>\n<li>Sie ben&#xF6;tigen ein <b>g&#xFC;ltiges Konto<\/b>, das sich in das Web&#x2011;Interface einloggen kann (Test empfohlen).<\/li>\n<li>Zwei-Faktor-Authentifizierung (2FA) ist deaktiviert. Wenn Sie 2FA weiterhin aktiviert lassen m&#xF6;chten, wenden Sie sich bitte an den Support (post.lu), um ein eingeschr&#xE4;nktes Konto ausschlie&#xDF;lich f&#xFC;r die API-Nutzung zu erhalten.<\/li>\n<li>Sie ben&#xF6;tigen die erforderlichen <b>API&#x2011;Berechtigungen<\/b>.<\/li>\n<\/ul>\n<hr>\n<h2><b>Authentifizierung<\/b><\/h2>\n<p>Alle API&#x2011;Requests ben&#xF6;tigen einen Basic&#x2011;Auth Header:<\/p>\n<pre>Authorization: Basic {Base64KodierteZugangsdaten}<\/pre>\n<hr>\n<h2><b>Inhaltsverzeichnis<\/b><\/h2>\n<ul>\n<li><a href=\"#get-zone-info\">1. Zoneninformationen abrufen<\/a><\/li>\n<li><a href=\"#get-zone-records\">2. DNS&#x2011;Eintr&#xE4;ge einer Zone abrufen<\/a><\/li>\n<li><a href=\"#export-zone\">3. Zone exportieren<\/a><\/li>\n<li><a href=\"#patch-add-arecord\">4. PATCH &#x2013; A&#x2011;Record hinzuf&#xFC;gen<\/a><\/li>\n<li><a href=\"#patch-remove-arecord\">5. PATCH &#x2013; A&#x2011;Record entfernen<\/a><\/li>\n<li><a href=\"#patch-add-txtrecord\">6. PATCH &#x2013; TXT&#x2011;Record hinzuf&#xFC;gen<\/a><\/li>\n<li><a href=\"#patch-remove-txtrecord\">7. PATCH &#x2013; TXT&#x2011;Record entfernen<\/a><\/li>\n<li><a href=\"#patch-add-cnamerecord\">8. PATCH &#x2013; CNAME&#x2011;Record hinzuf&#xFC;gen<\/a><\/li>\n<li><a href=\"#patch-remove-cnamerecord\">9. PATCH &#x2013; CNAME&#x2011;Record entfernen<\/a><\/li>\n<\/ul>\n<hr>\n<p><!----------------------------------------------><br>\n<!-- GET ENDPOINTS --><br>\n<!----------------------------------------------><\/p>\n<p><a id=\"get-zone-info\"><\/a><br>\n<b>======================================<\/b><br>\n<b> GET &#x2013; ZONENINFORMATIONEN<\/b><br>\n<b>======================================<\/b><\/p>\n<h2><b>1. Zoneninformationen abrufen<\/b><\/h2>\n<p><b>GET<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu<\/code><\/p>\n<p><b>Parameter<\/b><\/p>\n<ul>\n<li><b>Authorization<\/b> (Header)<\/li>\n<li><b>domain<\/b> (Pfadparameter)<\/li>\n<\/ul>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"expire\": \"2026-03-23T14:57:43.279Z\",&#13;\n  \"creation\": \"2026-03-23T14:57:43.279Z\",&#13;\n  \"lastChange\": \"2026-03-23T14:57:43.279Z\",&#13;\n  \"domain\": \"example.lu\",&#13;\n  \"contactArray\": [...],&#13;\n  \"nameserverArray\": [...],&#13;\n  \"resourceRecords\": [...],&#13;\n  \"domainStatus\": [...]&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>2. DNS&#x2011;Eintr&#xE4;ge einer Zone abrufen<\/b><\/h2>\n<p><b>GET<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records<\/code><\/p>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>[&#13;\n  {&#13;\n    \"group\": \"default\",&#13;\n    \"AResourceRecord\": [...],&#13;\n    \"CNAMEResourceRecord\": [...],&#13;\n    \"TXTResourceRecord\": [&#13;\n      { \"name\": \"example.lu.\", \"ttl\": 0, \"active\": true, \"text\": \"OtSANXuE\" },&#13;\n      { \"name\": \"example.lu.\", \"ttl\": 0, \"active\": true, \"text\": \"40plQl4A\" },&#13;\n      { \"name\": \"example.lu.\", \"ttl\": 0, \"active\": true, \"text\": \"hello 123\" },&#13;\n      { \"name\": \"example.lu.\", \"ttl\": 0, \"active\": true, \"text\": \"v=spf1 include:spf-strict.hostpack.lu -all\" }&#13;\n    ]&#13;\n  }&#13;\n]<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>3. Zone exportieren<\/b><\/h2>\n<p><b>GET<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/export<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/export<\/code><\/p>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>example.lu. 172800 IN NS ns1.pt.lu.&#13;\nexample.lu. 172800 IN NS ns3.pt.lu.&#13;\nexample.lu. 172800 IN NS ns2.pt.lu.&#13;\nexample.lu. 3600   IN MX 10 mx.hostpack.lu.&#13;\nsmtp.example.lu. 3600 IN CNAME outgoing.hostpack.lu.&#13;\napi.example.lu.  300  IN CNAME backend.example.lu.&#13;\nwww.example.lu.  3600 IN A 194.154.192.87&#13;\nexample.lu.      300  IN A 194.154.192.87&#13;\nexample.lu.      300  IN A 127.127.127.127&#13;\n<\/pre>\n<hr>\n<p><!----------------------------------------------><br>\n<!-- PATCH ENDPOINTS --><br>\n<!----------------------------------------------><\/p>\n<p><a id=\"patch-add-arecord\"><\/a><br>\n<b>======================================<\/b><br>\n<b> PATCH &#x2013; DNS&#x2011;EINTR&#xC4;GE &#xC4;NDERN<\/b><br>\n<b>======================================<\/b><\/p>\n<h2><b>4. A&#x2011;Record hinzuf&#xFC;gen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/add\/ARecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/add\/ARecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"hostAddress\": \"127.127.127.127\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261350443199\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>5. A&#x2011;Record entfernen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/remove\/ARecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/remove\/ARecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"hostAddress\": \"127.127.127.127\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261353158199\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>6. TXT&#x2011;Record hinzuf&#xFC;gen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/add\/TXTRecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/add\/TXTRecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"text\": \"66iCWhUr\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261345481210\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>7. TXT&#x2011;Record entfernen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/remove\/TXTRecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/remove\/TXTRecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"text\": \"66iCWhUr\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261355413680\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>8. CNAME&#x2011;Record hinzuf&#xFC;gen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/add\/CNAMERecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/add\/CNAMERecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"api.example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"hostname\": \"example.lu.copr.lu.\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261400502312\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n<p>&#xA0;<\/p>\n<h2><b>9. CNAME&#x2011;Record entfernen<\/b><\/h2>\n<p><b>PATCH<\/b>:<br>\n<code>https:\/\/api.mydomain.lu\/zones\/{domain}\/records\/remove\/CNAMERecord<\/code><br>\n<i>Beispiel:<\/i> <code>https:\/\/api.mydomain.lu\/zones\/example.lu\/records\/remove\/CNAMERecord<\/code><\/p>\n<p><b>Anfrage&#x2011;Body<\/b><\/p>\n<pre>{&#13;\n  \"name\": \"api.example.lu.\",&#13;\n  \"ttl\": \"300\",&#13;\n  \"active\": \"true\",&#13;\n  \"hostname\": \"example.lu.copr.lu.\"&#13;\n}<\/pre>\n<p><b>Antwort 200 OK<\/b><\/p>\n<pre>{&#13;\n  \"code\": 1001,&#13;\n  \"message\": \"Domain Zone Modify - Command completed successfully. Action pending.\",&#13;\n  \"ticket\": \"2603261400502312\",&#13;\n  \"infoMsg\": [],&#13;\n  \"errorMsg\": []&#13;\n}<\/pre>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>API&#x2011;&#xDC;bersicht Die mydomain.lu DNS Management API erm&#xF6;glicht die automatisierte Verwaltung von DNS&#x2011;Zonen. Sie bietet Funktionen zum Abrufen von Zonendaten, Exportieren von Zonendateien sowie zum Hinzuf&#xFC;gen, Aktualisieren oder Entfernen von DNS&#x2011;Eintr&#xE4;gen. Jede &#xC4;nderung erzeugt ein Ticket, da DNS&#x2011;Modifikationen asynchron verarbeitet werden. Eine Bestellung wird nacheinander verarbeitet. Du musst warten, bis die aktuelle Bestellung abgeschlossen ist, bevor &#x2026; <a href=\"https:\/\/support.pt.lu\/de\/api-documentation-mydomain-lu\/\" class=\"more-link\"><span class=\"screen-reader-text\">API-Dokumentation (mydomain.lu)<\/span> weiterlesen <span class=\"meta-nav\">&#x2192;<\/span><\/a><\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-3128","page","type-page","status-publish","hentry"],"translation":{"provider":"WPGlobus","version":"3.0.2","language":"de","enabled_languages":["en","de","fr"],"languages":{"en":{"title":true,"content":true,"excerpt":false},"de":{"title":true,"content":true,"excerpt":false},"fr":{"title":true,"content":true,"excerpt":false}}},"_links":{"self":[{"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/pages\/3128","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/comments?post=3128"}],"version-history":[{"count":37,"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/pages\/3128\/revisions"}],"predecessor-version":[{"id":3161,"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/pages\/3128\/revisions\/3161"}],"wp:attachment":[{"href":"https:\/\/support.pt.lu\/de\/wp-json\/wp\/v2\/media?parent=3128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}