Faire des requêtes | Documentation | WHOIS API | WhoisXML API

Formuler des demandes

Notre service Web Whois hébergé fournit les détails de l'enregistrement, également connus sous le nom d'enregistrements WHOIS, d'un nom de domaine, d'une adresse IP ou d'une adresse électronique.

WhoisXMLAPI.com fournit des API RESTful. Il est conçu pour la communication de serveur à serveur entre votre système et le réseau WhoisXMLAPI.com en utilisant le protocole HTTPs. Les réponses aux requêtes sont livrées au format XML ou JSON en fonction de vos demandes qui sont faites via les méthodes GET/POST.

Pour commencer, vous avez besoin d'un compte sur WhoisXmlApi.com. L'authentification est requise à chaque fois chaque fois pour utiliser l'API. Les 500 premiers appels à l'API WHOIS sont gratuits lorsque vous vous enregistrez pour un compte gratuit.

Points d'extrémité de l'API

Vous pouvez utiliser les points de terminaison suivants pour faire des demandes à l'API WHOIS :

  • Utiliser la méthode GET avec des paramètres de requête
  • Utiliser la méthode POST avec un corps JSON
GET https://www.whoisxmlapi.com/whoisserver/WhoisService?apiKey=API_KEY&domainName=google.com
POST https://www.whoisxmlapi.com/whoisserver/WhoisService
L'activation de votre compte après l'enregistrement prend jusqu'à une minute.

Exemple de requête cURL avec un corps au format JSON

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

Exemple de requête cURL avec un en-tête Authorization

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

Collection de Postman

Postman est une application web et de bureau qui vous permet de faire des demandes à une API à partir d'une interface utilisateur graphique. Nous recommandons d'utiliser Postman avec les points d'extrémité des API WhoisXML pour explorer les fonctionnalités des API, ainsi que pour résoudre les problèmes liés à votre application.

La collection Postman de l'API WhoisXML est disponible aux liens suivants :

La collection comprend un environnement préconfiguré. Vous devrez configurer la clé_api pour déclencher chaque requête. Obtenez votre CLÉ d'API personnelle sur la page Mes produits. Si vous avez des questions relatives à l'API, contactez-nous.

Authorization : required

Utilisez votre clé API personnelle ou votre jeton Server-to-Server OAuth pour authentifier vos demandes. Vous trouverez votre clé API sur la page Mes produits. La clé apiKey a la priorité la plus élevée. Si vous fournissez le paramètre de requête apiKey le service ignorera le paramètre Authorization s'il est présent.

Via le paramètre d'interrogation

apiKey

Obtenez votre clé API personnelle sur la page Mes produits.

Via l'en-tête

Autorization

API key or Server-to-Server OAuth token.

Authentication scheme: Bearer.

Exemple :
Authorization: Bearer %API_KEY%
Authorization: Bearer %OAUTH_ACCESS_TOKEN%

Paramètres d'entrée : requis

domainName

Le domaine/IPv4/IPv6/adresse électronique pour lequel les données WHOIS sont demandées.

Paramètres d'entrée : optionnels

outputFormat

Format de sortie de la réponse.

Valeurs acceptables : JSON | XML

Par défaut : XML

preferFresh

1 permet d'obtenir le dernier enregistrement WHOIS, même s'il est incomplet.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

da

1 permet de vérifier rapidement la disponibilité d'un domaine, 2 est plus lent mais plus précis. Les résultats sont renvoyés sous WhoisRecord → domainAvailability (AVAILABLE | UNAVAILABLE | UNDETERMINED)

Valeurs acceptables : 0 | 1 | 2

Valeur par défaut : 0

ip

1 renvoie des adresses IP pour le nom de domaine.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

ipWhois

1 renvoie l'enregistrement WHOIS pour l'IP d'hébergement si l'enregistrement WHOIS pour le tld du domaine d'entrée n'est pas pris en charge.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

checkProxyData

1 permet de récupérer les données de garde du proxy/WHOIS, si elles existent, dans l'élément de schéma WhoisRecord → privateWhoisProxy.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

thinWhois

1 permet de renvoyer les données WHOIS du registre uniquement, sans récupérer les données du bureau d'enregistrement. Les données de registre renvoyées correspondent à l'élément de schéma WhoisRecord → registryData.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

ignoreRawTexts

1 a pour effet de supprimer tout le texte brut de la sortie.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

callback

Une fonction javascript utilisée lorsque outputFormat est JSON ; il s'agit d'une implémentation connue sous le nom de JSONP qui invoque le callback sur la réponse renvoyée.

registryRawText

Une chaîne représentant le texte brut du WHOIS du registre à analyser ; ne fonctionne que si le paramètre _parseest égal à 1.

registrarRawText

Chaîne représentant le texte brut du WHOIS du bureau d'enregistrement à analyser ; ne fonctionne que si le paramètre _parse est égal à 1.

multiIdIana

1 entraîne une correspondance IANA multi ID pour l'analyse de registrarName afin d'obtenir registrarIANAID lorsqu'il ne s'agit pas d'une correspondance stricte.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

_parse

1 permet d'analyser les textes bruts du WHOIS décrits ci-dessous.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

_hardRefresh

1 fournit des données en temps réel, mais coûte 5 crédits API WHOIS.

Valeurs acceptables : 0 | 1

Valeur par défaut : 0

Accès gratuit

Après l'inscription, vous bénéficiez automatiquement d'un plan d'abonnement gratuit limité à 500 requêtes.