Authentification

Toutes les requêtes API nécessitent un jeton API valide transmis dans l'en-tête Authorization. Les jetons sont des JWTs signés avec l'identité de votre compte, de sorte que tout accès aux données respecte automatiquement les autorisations de votre compte.

Créer un jeton

Utiliser votre jeton

Incluez le jeton comme jeton Bearer dans l'en-tête Authorization :

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();

Gérer les jetons

Afficher les jetons

La page des paramètres Clés API affiche tous vos jetons actifs :

• Nom : le libellé que vous avez attribué
• Créé : la date de création du jeton
• Dernière utilisation : la dernière fois que le jeton a été utilisé pour effectuer une requête

Révoquer les jetons

Cliquez sur l'icône de la corbeille à côté d'un jeton pour le révoquer. La révocation est immédiate : les requêtes qui utilisent ce jeton reçoivent immédiatement des réponses 401 Unauthorized.

Limites des jetons

Vous pouvez avoir jusqu'à 5 jetons actifs à la fois. Si vous en avez besoin de davantage, révoquez d'abord un jeton inutilisé.

Réponses aux erreurs

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

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