Site.nl

Domeinnamen met punycode bestellen via de API

4 min lezen

Domeinnamen met punycode bestellen via de API

Wil je een domeinnaam met speciale tekens, zoals münchen.de of café.fr? Op internet wordt zo'n domeinnaam in punycode geschreven: alleen gewone letters, cijfers en koppeltekens, beginnend met xn--. Zo wordt münchen.de bijvoorbeeld xn--mnchen-3ya.de.

Je bestelt deze domeinnamen met dezelfde API-aanroepen als elke andere domeinnaam. In deze handleiding lees je wat er anders is. Bestel je voor het eerst via onze API? Lees dan eerst hoe je domeinnamen bestelt met de API.

Stap 1: zet de domeinnaam om

Stuur de domeinnaam zoals je hem schrijft. Hiervoor heb je geen API-sleutel nodig:

POST https://backend.site.nl/v2/domain_names/punycode
Content-Type: application/json

In de body stuur je input mee, bijvoorbeeld münchen.de. In het antwoord staat:

  • punycode: de domeinnaam in punycode, zoals xn--mnchen-3ya.de.
  • language_codes: alleen als de extensie wil weten in welke taal de domeinnaam is. Hieronder lees je hoe je de juiste code kiest.

We controleren ook of de extensie deze tekens toestaat. Niet elke extensie doet dat: bij .nl bestaan bijvoorbeeld geen domeinnamen met speciale tekens. Dan krijg je een fout, en in supported_tlds staan de extensies die ze wel toestaan.

Wil je eerst weten of een extensie überhaupt speciale tekens toestaat? Vraag de extensie dan op, zonder punt. Ook hiervoor heb je geen API-sleutel nodig:

GET https://backend.site.nl/v2/tlds?extension=com

Staat er in het antwoord isIDN: true? Dan accepteert de extensie domeinnamen met speciale tekens.

Vraagt de extensie om een taal?

Kijk naar het antwoord van stap 1:

  • Geen language_codes in het antwoord? Dan vraagt de extensie niet om een taal. Je stuurt geen language_code mee.
  • Wel language_codes in het antwoord? Kies dan de code voor de taal van je domeinnaam. Die stuur je mee in stap 3.

In de lijst staan alleen de codes, en elke registry schrijft die op zijn eigen manier. Sommige gebruiken twee kleine letters, zoals "de" voor Duits. Andere gebruiken drie hoofdletters, zoals "GER" bij .com en .net. Neem de code precies over zoals hij in de lijst staat, met dezelfde hoofdletters of kleine letters.

Dit zijn de codes voor onze talen:

  • Nederlands: nl of DUT
  • Duits: de of GER
  • Frans: fr of FRE
  • Spaans: es of SPA
  • Pools: pl of POL
  • Zweeds: sv of SWE
  • Sloveens: sl of SLV
  • Kroatisch: hr of SCR

Staat de code voor jouw taal niet in language_codes? Sommige extensies hebben ook codes voor een heel alfabet, zoals latn of und-Latn voor het Latijnse alfabet, of cyrl voor het cyrillische alfabet. Kies dan de code die past bij de letters in je domeinnaam. Past er geen enkele code? Dan accepteert deze extensie geen domeinnamen in jouw taal. Kies een andere extensie.

Stap 2: controleer of de domeinnaam nog vrij is

GET https://backend.site.nl/v2/domain_names/check_availability?domain_name=xn--mnchen-3ya.de

Gebruik hier de punycode. Die heeft geen speciale tekens, dus je kunt hem zo in het webadres zetten. Ook voor deze aanroep heb je geen API-sleutel nodig.

Stap 3: bestel de domeinnaam

POST https://backend.site.nl/v2/domain_names/register
X-API-Key: your API key
Content-Type: application/json

In de body stuur je domain_name mee, in punycode of zoals je hem schrijft. Wij slaan hem altijd op in punycode. Je API-sleutel heeft domains.order.create nodig, zoals bij elke bestelling van een domeinnaam.

Kreeg je in stap 1 language_codes terug? Stuur dan ook language_code mee, met de code die je hebt gekozen. Voor müller.com is dat GER (Duits). Een code die niet in de lijst staat, wordt geweigerd. Er wordt dan niets afgeschreven.

Een verhuizing werkt op dezelfde manier, met POST /v2/domain_names/transfer. Verder werkt alles zoals bij elke andere domeinnaam: dry_run, de Idempotency-Key, expected_price en de foutcodes. Test dus eerst met dry_run.

Goed om te weten

  • Hoofdletters worden kleine letters. MÜNCHEN.de en münchen.de zijn dezelfde domeinnaam.
  • ß en ss zijn niet hetzelfde. straße.de (xn--strae-oqa.de) en strasse.de zijn twee verschillende domeinnamen.
  • Wil je de speciale tekens terug? POST /v2/domain_names/unicode zet punycode om naar de gewone schrijfwijze. Zo wordt xn--mller-kva.com weer müller.com. Hiervoor heb je geen API-sleutel nodig.
  • Sommige programma's tonen de punycode. Een aantal e-mailprogramma's en oudere browsers laat xn--mnchen-3ya.de zien in plaats van münchen.de. Beide leiden naar dezelfde website.

Hulp nodig? Neem contact met ons op via WhatsApp, Telegram of e-mail.

Niet het antwoord gevonden dat je zocht?

Vergeet niet dat je altijd kunt chatten met één van onze professionele medewerkers!

Nieuwe artikelen toegevoegd