Server-to-Server OAuth

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

Utilisez le type d'autorisation « accessToken » pour générer un jeton d’accès. Les caractéristiques de ce type d’autorisation sont les suivantes :

• La durée de vie du jeton est de 1 800 (30 minutes), 3 600 (1 heure), 7 200 (2 heures) ou 10 800 secondes (3 heures). La valeur par défaut est de 3 600 secondes (1 heure).
• Il n'y a pas de jeton d'actualisation.
• 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 tous les produits auxquels vous avez accès.

Veuillez noter que l' accessToken est utilisé à la place de l’ apiKey dans les requêtes API.

API endpoint

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

Paramètres d'entrée

Réponse

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

Utilisez le accessToken de la réponse pour authentifier vos requêtes API. Remplacez la valeur obtenue par la clé champ « apiKey » comme vous le feriez avec une clé API classique sans OAuth.

Erreurs

{
    "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 requête GET via l'API WHOIS de cURL avec un jeton d'accès

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

Exemple de requête POST à l'API WHOIS via cURL avec un 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"
    }'