Du möchtest einen Domainnamen mit Sonderzeichen wie münchen.de oder café.fr? Im Internet wird so ein Domainname in Punycode geschrieben: nur einfache Buchstaben, Ziffern und Bindestriche, mit xn-- am Anfang. Aus münchen.de wird also xn--mnchen-3ya.de.
Du bestellst diese Domainnamen mit denselben API-Aufrufen wie jeden anderen Domainnamen. In dieser Anleitung erfährst du, was anders ist. Du bestellst zum ersten Mal über unsere API? Dann lies zuerst, wie du Domainnamen mit der API bestellst.
Schritt 1: Domainnamen umwandeln
Schick den Domainnamen so, wie du ihn schreibst. Dafür brauchst du keinen API-Schlüssel:
POST https://backend.site.de/v2/domain_names/punycode
Content-Type: application/json
Im Body schickst du input mit, zum Beispiel münchen.de. Die Antwort liefert:
- punycode: der Domainname in Punycode, zum Beispiel xn--mnchen-3ya.de.
- language_codes: nur, wenn die Endung die Sprache des Domainnamens verlangt. Weiter unten liest du, wie du den richtigen Code wählst.
Wir prüfen auch, ob die Endung diese Zeichen erlaubt. Nicht jede Endung tut das: Bei .nl zum Beispiel gibt es keine Domainnamen mit Sonderzeichen. Erlaubt die Endung sie nicht, bekommst du einen Fehler. Unter supported_tlds stehen dann die Endungen, die sie erlauben.
Du willst vorher wissen, ob eine Endung überhaupt Sonderzeichen annimmt? Dann frag die Endung ohne Punkt ab. Auch dafür brauchst du keinen API-Schlüssel:
GET https://backend.site.de/v2/tlds?extension=com
Steht in der Antwort isIDN: true? Dann nimmt die Endung Domainnamen mit Sonderzeichen an.
Verlangt die Endung eine Sprache?
Schau dir die Antwort aus Schritt 1 an:
- Keine language_codes in der Antwort? Dann verlangt die Endung keine Sprache. Das Feld language_code lässt du weg.
- language_codes in der Antwort? Dann wähl den Code der Sprache, in der dein Domainname geschrieben ist. Du schickst ihn in Schritt 3 mit.
Die Liste nennt nur die Codes, und jede Registrierungsstelle schreibt sie auf ihre eigene Art. Manche nutzen zwei Kleinbuchstaben, wie de für Deutsch. Andere nutzen drei Großbuchstaben, wie GER bei .com und .net. Übernimm den Code genau so, wie er in der Liste steht, mit denselben Groß- und Kleinbuchstaben.
Das sind die Codes für unsere Sprachen:
- Niederländisch: nl oder DUT
- Deutsch: de oder GER
- Französisch: fr oder FRE
- Spanisch: es oder SPA
- Polnisch: pl oder POL
- Schwedisch: sv oder SWE
- Slowenisch: sl oder SLV
- Kroatisch: hr oder SCR
Der Code für deine Sprache steht nicht in language_codes? Manche Endungen haben auch Codes für ein ganzes Alphabet, wie latn oder und-Latn für das lateinische Alphabet oder cyrl für das kyrillische Alphabet. Dann wähl den Code, der zu den Buchstaben in deinem Domainnamen passt. Kein Code passt? Dann nimmt diese Endung keine Domainnamen in deiner Sprache an. Wähl eine andere Endung.
Schritt 2: Prüfen, ob der Domainname noch frei ist
GET https://backend.site.de/v2/domain_names/check_availability?domain_name=xn--mnchen-3ya.de
Nutz hier den Punycode. Er enthält keine Sonderzeichen und passt deshalb unverändert in die Webadresse. Auch dieser Aufruf braucht keinen API-Schlüssel.
Schritt 3: Domainnamen bestellen
POST https://backend.site.de/v2/domain_names/register
X-API-Key: your API key
Content-Type: application/json
Im Body schickst du domain_name mit, in Punycode oder so, wie du ihn schreibst. Wir speichern ihn immer in Punycode. Dein API-Schlüssel braucht domains.order.create, wie bei jeder Bestellung eines Domainnamens.
Hat Schritt 1 language_codes geliefert? Dann schick auch language_code mit. Als Wert nimmst du den Code, den du gewählt hast. Bei müller.com ist das GER (Deutsch). Ein Code, der nicht in der Liste steht, wird abgelehnt, und es wird nichts abgebucht.
Eine Übertragung funktioniert genauso, mit POST /v2/domain_names/transfer. Alles andere läuft wie bei jedem anderen Domainnamen: dry_run, der Idempotency-Key, expected_price und die Fehlercodes. Teste also zuerst mit dry_run.
Gut zu wissen
- Großbuchstaben werden zu Kleinbuchstaben. MÜNCHEN.de und münchen.de sind derselbe Domainname.
- ß und ss sind nicht dasselbe. straße.de (xn--strae-oqa.de) und strasse.de sind zwei verschiedene Domainnamen.
- Du willst die Sonderzeichen zurück? POST /v2/domain_names/unicode wandelt Punycode wieder in die normale Schreibweise um. Aus xn--mller-kva.com wird also müller.com. Dafür brauchst du keinen API-Schlüssel.
- Manche Programme zeigen den Punycode an. Manche E-Mail-Programme und ältere Browser zeigen xn--mnchen-3ya.de statt münchen.de an. Beide führen zur selben Website.
Brauchst du Hilfe? Melde dich bei uns per WhatsApp, Telegram oder E-Mail.





