Commencez par obtenir un jeton d'accès avec Oauth2. Avec le jeton d'accès, vous pouvez effectuer des requêtes API. L'obtention d'un jeton d'accès peut se faire facilement en 2 étapes simples. Tout d'abord, tu auras besoin d'un jeton d'autorisation, qui pourra ensuite être échangé contre un jeton d'accès.

Étape 1 : récupération d'un code d'autorisation

La première étape pour obtenir un jeton d'accès consiste à obtenir un code d'autorisation qui pourra finalement être échangé contre un jeton d'accès. Tu peux obtenir un code d'autorisation en te rendant à l'URL d'autorisation du flux Oauth2 avec les paramètres corrects. Modifie les paramètres de l'URL d'autorisation ci-dessous avec le client_id correct, une URI de redirection correcte et les scopes corrects. Dans ce cas, nous utilisons http://localhost/ comme URI de redirection. Et fournis une valeur pour le paramètre d'état. Ceci est utilisé par le client pour maintenir l'état entre la requête et le rappel. Le serveur d'autorisation inclut cette valeur lors de la redirection de l'agent utilisateur vers le client.

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/

Lorsque tu visites le point de terminaison d'autorisation, il te sera demandé de te connecter à Cryptohopper si tu ne l'as pas encore fait, et ensuite il te sera demandé d'approuver les scopes d'accès de l'application. Lorsque tu cliques sur approuver, tu seras redirigé vers ton URI de redirection. Dans la requête vers l'URI de redirection, le code d'autorisation sera ajouté à la requête en tant que paramètre GET appelé : code. Sauvegarde ce code car tu en auras besoin à l'étape suivante pour l'échanger contre un jeton d'accès.

Étape 2 : échange du code d'autorisation contre un jeton d'accès

Maintenant que tu as un code d'autorisation, nous pouvons l'échanger contre un jeton d'accès en effectuant une requête POST json vers le point de terminaison du jeton du flux Oauth. L'appel API vers le point de terminaison d'autorisation doit être une requête POST codée en JSON. Si tu n'as aucune expérience en programmation, tu peux utiliser un site web comme https://reqbin.com/. Tu trouveras ci-dessous les détails du point de terminaison du jeton. Modifie les paramètres client_id et code dans l'exemple JSON.

Point de terminaison de l'API :

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

JSON :

{
"client_id": "La clé d'application de ton application.",
"client_secret": "Le secret d'application de ton application.",
"grant_type": "authorization_code",
"redirect_uri": "Ton URL de redirection",
"code": "Le jeton/code d'autorisation reçu à la première étape."
}

Après une requête réussie, tu recevras une réponse JSON contenant le access_token. Copie et enregistre ce jeton d'accès dans un endroit sûr.

Réponse JSON :

{
"access_token": "Le jeton d'accès retourné.",
"expires_in": "Le nombre de secondes pendant lesquelles le jeton d'accès sera valide.",
"token_type": "Bearer",
"scope": "read,manage,trade",
"refresh_token": "Le jeton de rafraîchissement retourné."
}

Félicitations ! Tu as maintenant obtenu un jeton d'accès que tu peux utiliser pour effectuer des requêtes API. Pour plus d'informations sur l'authentification avec Oauth2, veuillez en savoir plus sur notre page authentication.