Tutoriales

Obtener un token de acceso con OAuth2

 

Empieza por obtener un token de acceso con Oauth2. Con el token de acceso puedes realizar peticiones de API. Obtener un token de acceso se puede hacer fácilmente en 2 simples pasos. Primero necesitarás un token de concesión, que luego podrás intercambiar por un token de acceso.

Paso 1: obtener un código de concesión

El primer paso para obtener un token de acceso es obtener un código de concesión que eventualmente se puede intercambiar por un token de acceso. Puedes obtener un código de concesión yendo a la URL de autorización del flujo Oauth2 con los parámetros correctos. Cambia los parámetros en la URL de autorización de abajo con el client_id correcto, una URI de redirección correcta y los alcances correctos. En este caso, usamos http://localhost/ como la URI de redirección y proveemos un valor para el parámetro de estado. Esto es usado por el cliente para mantener el estado entre la petición y el callback. El servidor de autorización incluye este valor cuando redirige el user-agent al cliente.

https://www.cryptohopper.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&state=SOME_STATE&response_type=code&scope=read,notifications,manage,trade&redirect_uri=http://localhost/

Cuando visites el endpoint de autorización, se te pedirá que inicies sesión en Cryptohopper si aún no lo has hecho y, luego, se te pedirá que apruebes los alcances de acceso de la aplicación. Cuando hagas clic en aprobar, serás redirigido de vuelta a tu URI de redirección. En la petición a la URI de redirección, el código de concesión se agregará a la petición como un parámetro GET llamado: code. Guarda este código porque lo necesitarás en el siguiente paso para canjearlo por un token de acceso.

Paso 2: canjear el código de concesión por un token de acceso

Ahora que tienes un código de concesión, podemos intercambiarlo por un token de acceso haciendo una petición POST json al endpoint del token del flujo Oauth. La llamada a la API al endpoint de autorización necesita ser una petición POST codificada en JSON. Si no tienes experiencia en codificación, podrías usar un sitio web como https://reqbin.com/. Debajo encontrarás detalles del endpoint del token. Cambia los parámetros client_id y code en el ejemplo JSON.

API endpoint:

https://www.cryptohopper.com/oauth2/token

JSON:

{
"client_id": "La clave de la app de tu aplicación.",
"client_secret": "El secreto de la app de tu aplicación.",
"grant_type": "authorization_code",
"redirect_uri": "Tu URL de redirección",
"code": "El token/código de concesión recibido en el primer paso."
}

Después de una petición con éxito, recibirás una respuesta JSON que contiene el access_token. Copia y guarda este token de acceso en un lugar seguro.

Respuesta JSON:

{
"access_token": "El token de acceso devuelto.",
"expires_in": "El número de segundos que el token de acceso será válido.",
"token_type": "Bearer",
"scope": "read,manage,trade",
"refresh_token": "El token de actualización devuelto."
}

¡Felicidades! Ahora has obtenido un token de acceso que puedes usar para hacer peticiones a la API. Para más información sobre la autenticación con Oauth2, lee más en nuestra página de autenticación.