Authenticatie

Bouw je een product voor andere R+D-gebruikers? Begin bij Een app bouwen voor ontwikkelaarstoegang, registratie en platformvoorbeelden.

Alle API-aanvragen vereisen een geldig token in de Authorization-header. Persoonlijke API-tokens zijn ondoorzichtige toegangsgegevens voor je account. Externe producten kunnen OAuth-koppelingen gebruiken wanneer deze in hun omgeving zijn ingeschakeld.

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"
}