Authentifizierung

Für alle API-Anfragen ist ein gültiges API-Token erforderlich, das im Authorization-Header übergeben wird. Token sind JWTs, die mit der Identität Ihres Kontos signiert werden, sodass jeder Datenzugriff automatisch Ihre Kontoberechtigungen berücksichtigt.

Token erstellen

Token verwenden

Fügen Sie das Token als Bearer-Token in den Authorization-Header ein:

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 verwalten

Tokens anzeigen

Auf der Einstellungsseite API-Schlüssel werden alle Ihre aktiven Tokens angezeigt:

• Name — die von Ihnen zugewiesene Bezeichnung
• Erstellt — wann das Token erstellt wurde
• Zuletzt verwendet — wann das Token zuletzt für eine Anfrage verwendet wurde

Token widerrufen

Klicken Sie auf das Papierkorbsymbol neben einem Token, um es zu widerrufen. Der Widerruf erfolgt sofort – Anfragen, die dieses Token verwenden, erhalten unmittelbar Antworten mit 401 Unauthorized.

Token-Limits

Sie können bis zu 5 aktive Tokens gleichzeitig haben. Wenn Sie mehr benötigen, widerrufen Sie zunächst ein nicht verwendetes Token.

Fehlerantworten

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

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