Loading...

Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Paso 3: Generar Access Token y Refresh Token

Ejecución de la solicitud

Después de obtener el Grant Token, envía una solicitud POST a la siguiente URL con los parámetros indicados a continuación para generar el access_token:

https://accounts.zoho.com/oauth/v2/token?

Nota: Debes acceder a los dominios respectivos para los otros centros de datos:

  • EU: https://accounts.zoho.eu/
  • AU: https://accounts.zoho.au/
  • IN: https://accounts.zoho.in/
  • CA: https://accounts.zohocloud.ca/
  • JP: https://accounts.zohocloud.jp/
  • SA: https://accounts.zohocloud.sa/

Parámetro Descripción
code* El Grant Token o el valor de code obtenido en el paso anterior.
client_id* El Client ID que se generó durante el registro del cliente
client_secret* El Client Secret que se generó durante el registro del cliente
grant_type* authorization_code (Proporciona esta cadena literal como valor)
redirect_uri Una de las URIs de redirección autorizadas que proporcionaste al registrar el cliente en el paso anterior. No debes proporcionar una URI de redirección no registrada.
scope El scope para el cual se generará el access_token. Puedes proporcionar múltiples scopes separándolos con comas.
Puedes consultar la lista de scopes disponibles en Catalyst en [esta sección](/es/api/oauth2/scopes/).
state Una cadena opaca que se transmite de ida y vuelta en el protocolo. En otras palabras, cualquier valor que proporciones aquí se te devolverá.

Nota:

  • Los campos marcados con * son obligatorios.
  • Puedes pasar los parámetros en el cuerpo de tu solicitud como form-data, para mayor seguridad.
  • El access_token expirará después del período de tiempo (en segundos) mencionado en el parámetro expires_in.
  • Sin embargo, el refresh_token es permanente y se puede usar para regenerar un nuevo access_token si el actual expira.
  • Puedes usar el dominio especificado en api_domain en tus solicitudes para hacer llamadas a la API de Catalyst.
  • El valor “Bearer” en token_type indica que se trata de un access_token.

Esto completa el proceso de autenticación. Una vez que obtengas el access_token para tu aplicación, puedes usarlo en el encabezado de autorización de tus solicitudes HTTP para acceder a las APIs de Catalyst. Puedes consultar la sección Formato de solicitud para ver un ejemplo.

Nota: Cada vez que se acepta una página de reconsentimiento, se genera un nuevo refresh_token. Puedes generar un máximo de 20 refresh tokens por usuario y 5 refresh tokens por minuto. Si se supera este límite, el primer refresh_token se elimina automáticamente para dar cabida al más reciente. Esto se hace independientemente de si el primero está en uso o no.

Sample Response
copy
{
    "access_token": "{access_token}",
    "refresh_token": "{refresh_token}",
    "api_domain": "https://www.zohoapis.com",
    "token_type": "Bearer",
    "expires_in": 3600
}