Site.es

Cómo pedir nombres de dominio en punycode con la API

4 min de lectura

Cómo pedir nombres de dominio en punycode con la API

¿Quieres un nombre de dominio con caracteres especiales, como münchen.de o café.fr? En internet, un nombre de dominio así se escribe en punycode: solo letras normales, números y guiones, y empieza por xn--. Así, münchen.de se convierte en xn--mnchen-3ya.de.

Estos nombres de dominio los pides con las mismas llamadas a la API que cualquier otro nombre de dominio. Esta guía explica qué cambia. ¿Es la primera vez que haces pedidos con nuestra API? Entonces lee primero cómo pedir nombres de dominio con la API.

Paso 1: convierte el nombre de dominio

Envía el nombre de dominio tal como lo escribes. Para esto no necesitas una clave API:

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

En el cuerpo envías input, por ejemplo münchen.de. La respuesta te da:

  • punycode: el nombre de dominio en punycode, como xn--mnchen-3ya.de.
  • language_codes: solo si la extensión pide el idioma del nombre de dominio. Más abajo te explicamos cómo elegir el código correcto.

También comprobamos si la extensión admite estos caracteres. No todas los admiten: .nl, por ejemplo, no tiene nombres de dominio con caracteres especiales. En ese caso recibes un error, y supported_tlds enumera las extensiones que sí los admiten.

¿Quieres saber antes si una extensión admite caracteres especiales? Entonces consulta la extensión, sin el punto. Para esto tampoco necesitas una clave API:

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

¿La respuesta dice isIDN: true? Entonces la extensión admite nombres de dominio con caracteres especiales.

¿La extensión pide un idioma?

Mira la respuesta del paso 1:

  • ¿No hay language_codes en la respuesta? Entonces la extensión no pide ningún idioma. No envías language_code.
  • ¿Hay language_codes en la respuesta? Entonces elige el código del idioma de tu nombre de dominio. Lo envías en el paso 3.

La lista solo da los códigos, y cada registro los escribe a su manera. Algunos usan dos letras minúsculas, como de para el alemán. Otros usan tres letras mayúsculas, como GER para .com y .net. Copia el código exactamente como aparece en la lista, con las mismas mayúsculas o minúsculas.

Estos son los códigos de nuestros idiomas:

  • Neerlandés: nl o DUT
  • Alemán: de o GER
  • Francés: fr o FRE
  • Español: es o SPA
  • Polaco: pl o POL
  • Sueco: sv o SWE
  • Esloveno: sl o SLV
  • Croata: hr o SCR

¿El código de tu idioma no está en language_codes? Algunas extensiones también tienen códigos para un alfabeto entero, como latn o und-Latn para el alfabeto latino, o cyrl para el alfabeto cirílico. En ese caso, elige el que corresponda a las letras de tu nombre de dominio. ¿No encaja ningún código? Entonces esta extensión no admite nombres de dominio en tu idioma. Elige otra extensión.

Paso 2: comprueba si sigue libre

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

Aquí usa el punycode. No tiene caracteres especiales, así que puedes ponerlo tal cual en la dirección web. Esta llamada tampoco necesita una clave API.

Paso 3: pídelo

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

En el cuerpo envías domain_name, en punycode o tal como lo escribes. Nosotros siempre lo guardamos en punycode. Tu clave API necesita domains.order.create, como para cualquier pedido de nombre de dominio.

¿El paso 1 te ha dado language_codes? Entonces envía también language_code, con el código que has elegido. Para müller.com, es GER (alemán). Un código que no esté en la lista se rechaza y no se cobra nada.

Una transferencia funciona igual, con POST /v2/domain_names/transfer. Todo lo demás funciona como con cualquier otro nombre de dominio: dry_run, la Idempotency-Key, expected_price y los códigos de error. Así que prueba primero con dry_run.

Conviene saberlo

  • Las mayúsculas se convierten en minúsculas. MÜNCHEN.de y münchen.de son el mismo nombre de dominio.
  • ß y ss no son lo mismo. straße.de (xn--strae-oqa.de) y strasse.de son dos nombres de dominio distintos.
  • ¿Quieres recuperar los caracteres especiales? POST /v2/domain_names/unicode convierte el punycode de nuevo en la escritura normal. Así, xn--mller-kva.com se convierte en müller.com. No necesitas una clave API.
  • Algunos programas muestran el punycode. Algunos programas de correo y navegadores antiguos muestran xn--mnchen-3ya.de en lugar de münchen.de. Ambos llevan al mismo sitio web.

¿Necesitas ayuda? Contacta con nosotros por WhatsApp, Telegram o correo electrónico.

¿No has encontrado lo que buscabas?

¡Siempre puedes chatear con uno de nuestros expertos en caso de que tengas cualquier pregunta!

Nuevos artículos añadidos