Authentification

Clés API, Bearer et Device Flow

​

Authentification

L’API v1 accepte deux formes principales d’authentification par clé :

• x-api-key: <clé>
• Authorization: Bearer <clé>

Les clés dejaVu utilisent généralement les préfixes pk_ et sk_.

​

Clé publique

Une clé pk_ est destinée aux opérations de lecture.

curl https://dejavu.plus/api/v1/me \
  -H "x-api-key: pk_VOTRE_CLE"

​

Clé secrète

Une clé sk_ peut être utilisée pour les opérations de lecture et d’écriture autorisées.

curl https://dejavu.plus/api/v1/lists \
  -H "Authorization: Bearer sk_VOTRE_CLE"

​

Ce qui n’est pas supporté

Ne transmettez pas une clé dans la query string :

/api/v1/me?api_key=...

Cette forme n’est pas supportée par l’API v1.

​

Device Flow

Le Device Flow est destiné notamment aux applications et appareils qui ne disposent pas d’un navigateur complet.

Le flux général est :

1. demander un code d’appareil ;
2. présenter le code ou le QR code à l’utilisateur ;
3. faire approuver l’appareil dans dejaVu ;
4. échanger le device_code contre un access token ;
5. utiliser le token retourné comme Bearer token.

Consultez les endpoints du groupe Auth pour les formats exacts des requêtes et réponses.

​

Sécurité

• Ne journalisez jamais les clés API.
• Ne placez jamais une clé secrète dans du JavaScript exécuté côté navigateur.
• Utilisez HTTPS pour toutes les requêtes.
• En cas de compromission, révoquez et recréez la clé concernée.