OAuth de servidor a servidor

Generar un token de acceso

Utilice el tipo de concesión para generar un token de acceso. Las características de este tipo de concesión son:

• La duración del token es de 1800 (30 minutos), 3600 (1 hora), 7200 (2 horas) o 10800 segundos (3 horas). El valor predeterminado es de 3600 segundos (1 hora).
• No hay ningún token de actualización.
• Puede generar y utilizar varios tokens de acceso.
• Cuando se genera la nueva clave de API, todos los tokens de acceso generados anteriormente quedan invalidados.
• Los tokens de acceso generados son válidos para cualquier producto al que tenga acceso.

Tenga en cuenta que el accessToken se utiliza en lugar de la apiKey en las solicitudes de API.

Punto final de la API

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

Encabezados

Parámetros de entrada

Respuesta

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

Utilice el accessToken de la respuesta para autenticar sus solicitudes de API. Sustituya el valor resultante en la campo tal y como lo haría con una clave de API normal sin OAuth.

Errores

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

Ejemplo de solicitud GET de la API WHOIS de cURL con token de acceso

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

Ejemplo de solicitud POST a la API WHOIS de cURL con token de acceso

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