Autenticación

Autenticación OAuth2

Cryptohopper utiliza OAuth2 para proporcionar acceso autorizado a su API.

Usando OAuth2

Entender cómo funciona OAuth2 puede ayudar a crear y depurar aplicaciones que usan la API de Cryptohopper. Para usar OAuth, una aplicación debe:

Obtener tokens de autorización para actuar en nombre de una cuenta de usuario.
Intercambiar los tokens de autorización por tokens de acceso.
Autorizar todas las solicitudes HTTP que envíe a las APIs de Cryptohopper.

El método de autenticación de usuario permite a una app actuar en nombre del usuario, como si fuera el propio usuario.

Ejemplo: si un desarrollador quisiera crear una función que permitiera a un bot de trading comprar una determinada criptomoneda a través de su plataforma usando el endpoint de compra, el desarrollador tendría que usar la autenticación de usuario para obtener permiso del usuario para operar en su nombre.

En otras palabras, una solicitud firmada identifica la identidad de la aplicación, además de los permisos otorgados al usuario final por el que la aplicación realiza las llamadas a la API, representados por el token de acceso del usuario.

La autenticación de usuario requiere la clave y el secreto de la app de tu Cryptohopper y el token de acceso y el secreto de acceso del usuario en cuyo nombre intentas actuar. Más información sobre los métodos OAuth a continuación:

Métodos OAuth2

autorizar

Con el endpoint autorizar, los usuarios pueden iniciar sesión en Cryptohopper y otorgar acceso a la aplicación. Después de otorgar el acceso correctamente o tras cualquier error, el usuario será redirigido a la URL de redirección. Si la URL de redirección no se especifica en la solicitud, se utiliza la URL de redirección de la configuración de la aplicación. En los parámetros GET de la URL de redirección recibirás el token de autorización que puede intercambiarse por un access_token.

Endpoint: https://www.cryptohopper.com/oauth2/authorize

Acepta: GET

Devuelve: código, estado en GET en la URL de redirección

Parámetros:

client_id: La clave de la app de tu aplicación.
response_type: El tipo de respuesta debe contener el texto: code.
redirect_uri: La URL de redirección a la que se redirigirán los usuarios después del proceso de OAuth.
state: Parámetro extra para reconocer las solicitudes en el lado de la aplicación. Se devolverá a la URL de redirección.
scope: Una lista separada por comas de ámbitos, por ejemplo: lectura, notificaciones, gestión, trading.

token

El endpoint token se utiliza para intercambiar un token/código de autorización por un access_token válido.

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

Acepta: POST en application/json

Devuelve: access_token y refresh_token en application/json

Parámetros:

client_id: La clave de la app de tu aplicación.
client_secret: El secreto de la app de tu aplicación.
grant_type: El tipo de autorización debe contener el texto: authorization_code.
redirect_uri: La URL de redirección de tu aplicación.
code: El token/código de autorización.

Códigos de respuesta exitosos

Cuando una solicitud al endpoint access_token tiene éxito, el usuario será redirigido a la URL de redirección con un token de autorización pasado como parámetros GET.

Una solicitud exitosa al endpoint token tendrá un código de respuesta 200 e incluirá un access_token en el cuerpo que se puede usar para autenticar las llamadas a la API.

Códigos de respuesta de error

Los errores retornados a la URL de redirección se reconocen por el parámetro GET retornado: error=1. A continuación, encontrarás posibles mensajes de error:

La clave de la aplicación es inválida.
La firma es inválida.
La clave de la aplicación no puede estar vacía.
El usuario no ha otorgado permiso a la aplicación.