Authenticatie

Indien applicaties gebruik willen maken van de Onderzoekstool API dienen deze zich eerst aan te melden en een ‘access token’ op te vragen. Deze pagina geeft een toelichting hoe dit token kan worden opgevraagd.

Authenticatie flow

De applicatie dient de volgende drie stappen uit te voeren:

  • De applicaties codeert middels Base64 de ‘consumer key’ en ‘consumer secret’ in een credential die gebruikt kan worden bij het opvragen van het token;
  • Via een authenticatie request wordt het token opgevraagd, Onderzoekstool stuurt vervolgens het token terug;
  • De applicatie dient vervolgens bij het gebruik van de REST-API elke request te voorzien van dit token.

Stap 1: coderen van de credential

Om een credential te coderen, dienen de volgende stappen doorlopen te worden:

  • Voeg de consumer key en secret samen, gescheiden door een ‘:’ karakter, tot één string;
  • Codeer deze string middels Base64.

Stap 2: access token opvragen

Met behulp van de gecodeerde credential kan nu een access token worden opgevraagd.

  • Het request dient een HTTP GET request zijn;
  • Het request dient verstuurd te worden via SSL;
  • Format van het authenticatie request:
    https://onderzoekstool.nl/edi.php/authenticate.json/credential
  • Onderzoekstool zal middels een JSON response een access token leveren.

Stap 3: gebruik van het token

Indien de authenticatie succesvol is verlopen zal Onderzoektool in een JSON response het access token in de volgende format opleveren:

  {
    "success":
    {
      "token_type":"bearer",
      "access_token":"5993Klje5z15Kx2Hx8m4xu7o7Pt213WE",
      "expires_at":"2016-07-04 14:56:17"
    }
  }

  • Een survey tool die intuïtief en flexibel is, maar tegelijkertijd robuust en betrouwbaar.

    Robert-Jan Simons, Corfides

  • Onderzoekstool.nl bleek de perfecte oplossing voor het maken van een ‘quick scan’, enquêtes en klanttevredenheidsonderzoeken. 

    Pieter Smit, Marketing Manager Nederland - TriFinance

  • Een vragenlijst is in een mum van tijd ingevoerd en vooral de rapportage tool vind ik geweldig. Kortom: ik ben erg tevreden!

    Saskia Derkx, Medisch Centrum Alkmaar

Een selectie van onze klanten