Skip to main content
Toutes les requêtes à l’API exigent un jeton bearer dans l’en-tête Authorization. Les jetons sont rattachés à votre équipe et donnent accès à toutes les marques de votre compte.

​
Obtenir un jeton d’API

1

Ouvrez API REST

Ouvrez Gestion de l’équipe > API REST.
2

Créez un nouveau jeton

Cliquez sur Nouveau jeton d’API et donnez-lui un nom explicite, comme analytics-export.
3

Copiez-le et conservez-le en lieu sûr

Votre jeton ne s’affiche qu’une seule fois. Copiez-le immédiatement et conservez-le en lieu sûr.
Ne commitez jamais de jeton dans un gestionnaire de versions et ne l’exposez jamais dans du code côté client. Révoquez un jeton compromis depuis Gestion de l’équipe > API REST.

​
Utiliser votre jeton

Incluez le jeton dans l’en-tête Authorization avec le préfixe Bearer :

​
Format des jetons

Tous les jetons d’API Qwairy suivent ce format :
Exemple : qw-api-a1b2c3d4e5f6789012345678abcdef01

​
Erreurs d’authentification

Les échecs d’authentification renvoient un HTTP 401 avec un corps plat. error est un court libellé de statut et message explique l’échec :

​
Exemple de réponse d’erreur

Consultez Codes d’erreur pour les formes d’erreur de passerelle et de ressource.

​
Bonnes pratiques de sécurité

Utilisez des variables d’environnement

Stockez les jetons dans des variables d’environnement, pas dans le code.

Choisissez des noms explicites

Nommez les jetons selon leur usage pour les gérer facilement.

Révoquez les jetons inutilisés

Supprimez les jetons qui ne servent plus à aucune intégration active.

Séparez les intégrations

Créez un jeton distinct pour chaque intégration.

​
Gérer les jetons

Gérez les jetons d’API depuis Gestion de l’équipe > API REST :
  • Voir les jetons : tous les jetons actifs avec leur date de dernière utilisation
  • Supprimer des jetons : la suppression d’un jeton révoque l’accès immédiatement
  • Créer des jetons : générez de nouveaux jetons selon vos besoins