Realizar solicitudes | Documentación | WHOIS API | WhoisXML API

Realizar solicitudes

Nuestro Hosted Whois Web Service proporciona detalles de registro, también conocidos como registros WHOIS, de un dominio, una dirección IP o una dirección de correo electrónico.

WhoisXMLAPI.com proporciona APIS RESTful. Está diseñada para la comunicación de servidor a servidor entre su sistema y la red WhoisXMLAPI.com, utilizando el protocolo HTTPs. Las respuestas a las consultas se entregan en formato XML o JSON en función de sus peticiones, que se realizan a través de los métodos GET/POST.

Para empezar necesita una cuenta en WhoisXmlApi.com. Se requiere autenticación cada vez para utilizar la API. Las primeras 500 llamadas a  WHOIS API son de cortesía si se registra mediante una cuenta gratuita.

Puntos finales de la API

Puede utilizar los siguientes puntos finales para realizar solicitudes a WHOIS API:

  • Utilice el método GET con parámetros de consulta
  • Utilice el método POST con cuerpo JSON
OBTENER https://www.whoisxmlapi.com/whoisserver/WhoisService?apiKey=API_KEY&domainName=google.com
POST https://www.whoisxmlapi.com/whoisserver/WhoisService
La activación de la cuenta tarda un minuto tras el registro.

Ejemplo de solicitud cURL con cuerpo en formato JSON

curl --location 'https://www.whoisxmlapi.com/whoisserver/WhoisService' \
    --header 'Content-Type: application/json' \
    --data '{
        "domainName": "google.com",
        "apiKey": "API_KEY"
    }'

Ejemplo de solicitud cURL con una cabecera de Autorización

curl --location 'https://www.whoisxmlapi.com/whoisserver/WhoisService?domainName=google.com' \
--header 'Autorización: Bearer %accessToken%'

Compilación Postman

Postman es una aplicación web y de escritorio que permite realizar llamadas a la API desde una interfaz gráica. Le recomendamos que utilice Postmancon los puntos finales de las API de WhoisXML cuando explore la funcionalidad de las API, así como cuando esté identificando problemas con su aplicación.

La compilación Postman de API de WhoisXML está disponible en los siguientes enlaces:

La compilación incluye un entorno preconfigurado. Tendrá que configurar la api_key para realizar cada solicitud. Obtenga su clave de API personal en la página Mis productos. Si tiene preguntas relacionadas con la API, póngase en contacto con nosotros.

Autorización: necesaria

Utilice su clave personal de API o su token OAuth de servidor a servidor para autenticar sus solicitudes. Puede encontrar su clave API en la página Mis productos. La dirección apiKey tiene la máxima prioridad. Si proporciona el parámetro apiKey el servicio ignorará el parámetro autorización si está presente.

Mediante el parámetro de consulta

apiKey

Obtenga su clave API personal en la página Mis productos.

A través de la cabecera

Autorización

Clave API o token OAuth de servidor a servidor.

Esquema de autenticación: Portador.

Ejemplo:
- Autorización: Portador %API_KEY%
- Autorización : Portador %OAUTH_ACCESS_TOKEN%

Parámetros de entrada: obligatorio

domainName

Dominio/IPv4/IPv6/dirección de correo electrónico para el que se solicitan los datos WHOIS.

Parámetros de entrada: opcional

outputFormat

Formato de salida de la respuesta.

Valores aceptados: JSON | XML

Por defecto: XML

preferFresh

1 da como resultado la obtención del último registro WHOIS aunque esté incompleto.

Valores aceptables: 0 | 1

Predeterminado: 0

da

1 da como resultado una comprobación rápida de la disponibilidad del dominio, 2 es más lento pero más preciso. Los resultados se devuelven en WhoisRecord → domainAvailability (AVAILABLE | UNAVAILABLE | UNDETERMINED).

Valores aceptables: 0 | 1 | 2

Predeterminado: 0

ip

1 da como resultado la devolución de las IP para el nombre de dominio.

Valores aceptables: 0 | 1

Predeterminado: 0

ipWhois

1 da como resultado la devolución del registro WHOIS para la IP de alojamiento si no se admite el registro WHOIS para el tld del dominio de entrada.

Valores aceptables: 0 | 1

Predeterminado: 0

checkProxyData

1 da como resultado la obtención de los datos de protección proxy/WHOIS, si existen, en el elemento del esquema WhoisRecord → privateWhoisProxy.

Valores aceptables: 0 | 1

Predeterminado: 0

thinWhois

1 solo devuelve los datos WHOIS del registro, sin obtener los datos del registrador. Los datos de registro devueltos corresponden al elemento del esquema WhoisRecord → registryData.

Valores aceptables: 0 | 1

Predeterminado: 0

ignoreRawTexts

1 hace que se elimine todo el texto en bruto de la salida.

Valores aceptables: 0 | 1

Predeterminado: 0

callback

Una función javascript utilizada cuando outputFormat es JSON; se trata de una implementación conocida como JSONP que invoca la llamada de retorno sobre la respuesta devuelta.

registryRawText

Una cadena que representa el texto WHOIS sin procesar del registro que debe analizarse; solo funciona cuando el parámetro _parse es igual a 1.

registrarRawText

Una cadena que representa el texto sin procesar  WHOIS del registrador que debe analizarse; solo funciona cuando el parámetro _parse es igual a 1.

multiIdIana

1 resulta en tener una coincidencia IANA multi ID para parsear registrarName para obtener registrarIANAID cuando no es una coincidencia estricta.

Valores aceptables: 0 | 1

Predeterminado: 0

_parse

1 proporciona el análisis sintáctico de los textos en bruto WHOIS de entrada que se describen a continuación.

Valores aceptables: 0 | 1

Predeterminado: 0

_hardRefresh

1 proporciona datos en tiempo real, pero le costará 5 créditos WHOIS API.

Valores aceptables: 0 | 1

Predeterminado: 0

Acceso gratuito

Tras registrarse, obtendrá automáticamente un plan de suscripción gratuito limitado a 500 consultas.