Begin met het verkrijgen van een toegangstoken met Oauth2. Met een toegangstoken kun je API requests uitvoeren. Het verkrijgen van een toegangstoken is gemakkelijk in 2 simpele stappen te doen. Eerst heb je een grant token nodig, die je vervolgens kunt omwisselen voor een toegangstoken.

Stap 1: een grant code verkrijgen

De eerste stap in het verkrijgen van een toegangstoken is het verkrijgen van een grant code, die uiteindelijk kan worden omgewisseld voor een toegangstoken. Je kunt een grant code verkrijgen door naar de authorise URL van de Oauth2 flow te gaan met de juiste parameters. Verander de parameters in de authorise URL hieronder met de correcte client_id, een correcte redirect URI en de correcte scopes. In dit geval gebruiken we http://localhost/ als de redirect URI. En geef een waarde op voor de state parameter. Deze wordt door de client gebruikt om de status te behouden tussen de request en de callback. De authorisation server bevat deze waarde wanneer het de user-agent terugstuurt naar de 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/

Wanneer je de authorize endpoint bezoekt, wordt je gevraagd om in Cryptohopper in te loggen als je dat nog niet gedaan hebt, en vervolgens wordt je gevraagd om de access scopes van de app goed te keuren. Wanneer je op goedkeuren klikt, word je teruggeleid naar je redirect URI. In de request naar de redirect URI wordt de grant code als GET parameter aan de request toegevoegd, genaamd: code. Sla deze code op, want je hebt hem nodig in de volgende stap om hem om te wisselen voor een toegangstoken.

Stap 2: wissel de grant code om voor een toegangstoken

Nu je een grant code hebt, kunnen we deze omwisselen voor een toegangstoken door een json POST request te doen naar de token endpoint van de Oauth flow. De API call naar de authorise endpoint moet een JSON encoded POST request zijn. Als je geen ervaring hebt met coderen, kun je een website zoals https://reqbin.com/ gebruiken. Hieronder vind je details van de token endpoint. Verander de client_id en code parameters in het JSON voorbeeld.

API endpoint:

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

JSON:

{
"client_id": "De app key van je applicatie.",
"client_secret": "De app secret van je applicatie.",
"grant_type": "authorization_code",
"redirect_uri": "Je redirect URL",
"code": "De grant token/code die je in de eerste stap hebt ontvangen."
}

Na een succesvolle request ontvang je een JSON response met daarin het access_token. Kopieer en bewaar dit access token op een veilige plaats.

JSON response:

{
"access_token": "De geretourneerde access token.",
"expires_in": "Het aantal seconden dat de toegangstoken geldig is.",
"token_type": "Bearer",
"scope": "read,manage,trade",
"refresh_token": "De geretourneerde refresh token."
}

Gefeliciteerd! Je hebt nu een toegangstoken verkregen waarmee je API requests kunt doen. Voor meer informatie over authenticatie met Oauth2, lees meer op onze authentication pagina.