Authenticatie

Voor alle API-verzoeken is een geldig API-token vereist dat wordt doorgegeven in de Authorization-header. Tokens zijn JWTs die zijn ondertekend met de identiteit van uw account, zodat elke toegang tot gegevens automatisch uw accountrechten respecteert.

Een token maken

Uw token gebruiken

Neem het token op als een Bearer-token in de Authorization-header:

curl -X GET \
  https://dashboard.researchanddesire.com/api/v1/users \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
response = requests.get(
    "https://dashboard.researchanddesire.com/api/v1/users",
    headers=headers,
)
data = response.json()

const response = await fetch(
  "https://dashboard.researchanddesire.com/api/v1/users",
  {
    headers: { Authorization: "Bearer YOUR_API_TOKEN" },
  },
);
const data = await response.json();

Tokens beheren

Tokens bekijken

De instellingenpagina API-sleutels toont al uw actieve tokens:

• Naam — het label dat u hebt toegewezen
• Aangemaakt — toen het token werd aangemaakt
• Laatst gebruikt — wanneer het token voor het laatst is gebruikt om een verzoek te doen

Tokens intrekken

Klik op het prullenbakpictogram naast een token om dit in te trekken. Het intrekken gebeurt onmiddellijk: verzoeken die dit token gebruiken, krijgen meteen antwoorden met 401 Unauthorized.

Tokenlimieten

U kunt maximaal 5 actieve tokens tegelijk hebben. Als u er meer nodig hebt, trek dan eerst een ongebruikt token in.

Foutreacties

{
  "ok": false,
  "error": "Missing or invalid Authorization header"
}

{
  "ok": false,
  "error": "Token has been revoked"
}