Server-zu-Server OAuth

Generieren Sie ein Zugriffstoken

Verwenden Sie den accessToken um ein Zugriffstoken zu erzeugen. Die Funktionen dieses Grant-Typs sind:

• Die Lebensdauer des Tokens beträgt 1800 (30 Minuten), 3600 (1 Stunde), 7200 (2 Stunden) oder 10800 Sekunden (3 Stunden). Die Voreinstellung ist 3600 Sekunden (1 Stunde).
• Es gibt kein Aktualisierungs-Token.
• Sie können mehrere Zugriffstoken erstellen und verwenden.
• Wenn der neue API-Schlüssel generiert wird, werden alle zuvor generierten Zugriffstoken ungültig.
• Die generierten Zugriffstoken sind für jedes Produkt gültig, auf das Sie Zugriff haben.

Bitte beachten Sie, dass der generierte accessToken anstelle des apiKey Parameter in API-Anfragen verwendet wird.

API-Endpunkt

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
}'

Kopfzeilen

Eingabe-Parameter

Antwort

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

Verwenden Sie den accessToken Wert in der Antwort, um Ihre API-Anfragen zu authentifizieren. Ersetzen Sie den resultierenden Wert in der Datei apiSchlüssel Feld ein, wie Sie es mit einem normalen API-Schlüssel ohne OAuth tun würden.

Fehler

{
    "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."
        ]
    }
}

Beispiel einer cURL WHOIS API GET-Anfrage mit Zugriffstoken

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

Beispiel einer cURL WHOIS API POST-Anfrage mit Zugriffstoken

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