Server-zu-Server-OAuth

Zugriffstoken generieren

Verwenden Sie das Zugriffstoken Grant-Typ, um ein Zugriffstoken zu generieren. Die Merkmale dieses Grant-Typs sind:

• Die Gültigkeitsdauer des Tokens beträgt 1800 (30 Minuten), 3600 (1 Stunde), 7200 (2 Stunden) oder 10800 Sekunden (3 Stunden). Der Standardwert beträgt 3600 Sekunden (1 Stunde).
• Es gibt kein Aktualisierungstoken.
• Sie können mehrere Zugriffstoken generieren und verwenden.
• Sobald der neue API-Schlüssel generiert wurde, werden alle zuvor generierten Zugriffstoken ungültig.
• Die generierten Zugriffstoken gelten für alle Produkte, auf die Sie Zugriff haben.

Bitte beachten Sie, dass das generierte accessToken anstelle des „apiKey“ 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
}'

Überschriften

Eingabeparameter

Antwort

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

Verwenden Sie das accessToken Wert aus der Antwort, um Ihre API-Anfragen zu authentifizieren. Setzen Sie den resultierenden Wert in den apiKey Feld ein, so wie Sie es bei 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 für eine GET-Anfrage an die cURL-WHOIS-API mit Zugriffstoken

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

Beispiel für eine POST-Anfrage an die cURL-WHOIS-API mit Zugriffstoken

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