Server-to-Server OAuth

Utilisez server-to-server OAuth pour vous authentifier avec les API de WhoisXML lorsque vous faites des requêtes d'API. Cette méthode est également connue sous le nom d'OAuth à deux pattes car elle utilise un processus en deux étapes qui ne nécessite pas d'interaction avec l'utilisateur pour l'authentification ou l'autorisation. Voici le processus.

Votre client server-to-server OAuth demande un jeton d'accès au serveur d'autorisation de WhoisXML API.
Votre client utilise le jeton d'accès pour effectuer des demandes d'API.

Vous pouvez également consulter ce script sur GitHub pour un exemple d'utilisation de WHOIS API avec Server-Side SSO.

Générer un jeton d'accès

Utiliser le accessToken pour générer un jeton d'accès. Les caractéristiques de ce type de subvention sont les suivantes

La durée de vie du jeton est de 1800 (30 minutes), 3600 (1 heure), 7200 (2 heures) ou 10800 secondes (3 heures). La valeur par défaut est de 3600 secondes (1 heure).
Il n'y a pas de jeton de rafraîchissement.
Vous pouvez générer et utiliser plusieurs jetons d'accès.
Lorsque la nouvelle clé API est générée, tous les jetons d'accès générés précédemment sont invalidés.
Les jetons d'accès générés sont valables pour tout produit auquel vous avez accès.

Veuillez noter que le accessToken est utilisé à la place de la apiKey dans les demandes d'API.

API endpoint

POST https://main.whoisxmlapi.com/oauth/token

curl --location 'https://main.whoisxmlapi.com/oauth/token' \
--header 'Authorization: Bearer %base64_encoded_API_key%' \
--header 'Content-Type: application/json' \
--data '{
    "grantType": "access_token",
    "expiresIn": 7200
}'

En-têtes

Autorization

Nécessaire. Clé API encodée en base64.

Authentication scheme: Bearer.

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

Paramètres d'entrée

grantType	Obligatoire. Le type de subvention pour générer un jeton d'accès. Valeurs acceptables : access_token.
expireIn	Facultatif. Durée de vie du jeton d'accès en secondes. Valeurs acceptables : 1800, 3600, 7200, 10800. Valeur par défaut : 3600.
outputFormat	Facultatif. Format de sortie de la réponse. Valeurs acceptables : JSON \| XML Par défaut : JSON

Response

{
    "accessToken": "G2OIE2AKRCVDYFUJCV5PXXXXXXXXXXXX",
    "expiresIn": 3600
}

Utiliser le accessToken dans la réponse pour authentifier vos demandes d'API. Remplacez la valeur obtenue par la valeur apiKey comme vous le feriez avec une clé d'API normale sans OAuth.

Errors

{
    "code": 401,
    "messages": "Access restricted. Check the credits balance or enter the correct API key."
}

{
    "code": 422,
    "messages": {
        "grantType": [
            "The selected grant type is invalid."
        ]
    }
}

Exemple de demande cURL WHOIS API GET avec jeton d'accès

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

Exemple de demande cURL WHOIS API POST avec jeton d'accès

curl --location 'https://www.whoisxmlapi.com/whoisserver/WhoisService' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer %accessToken%' \
    --data '{
        "domainName": "google.com"
    }'

WHOIS / WHOIS History

DNS / DNS History

IP Geolocation / IP Netblocks

Domain Research Suite (DRS)

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Domaine/WHOIS

DNS/IP

Renseignement

Autres

Domain Research Suite (DRS)

Recherche

Contrôle

Label blanc

Predictive Threat Intelligence

Infrastructure Internet

Enterprise API Packages

Security Intelligence (SI) Suite

Premium API Services

Server-to-Server OAuth

Générer un jeton d'accès

API endpoint

En-têtes

Paramètres d'entrée

Response

Errors

Exemple de demande cURL WHOIS API GET avec jeton d'accès

Exemple de demande cURL WHOIS API POST avec jeton d'accès

Vous avez des questions ?