Passer au contenu principal

Clé API et secret

La clé API et le secret (également appelés clé et secret client) sont les identifiants les plus fondamentaux nécessaires pour accéder à la X API. Ces identifiants jouent le rôle de nom d’utilisateur et de mot de passe pour votre App X et sont utilisés par la X API pour identifier de quelle App proviennent les requêtes.  Ces identifiants peuvent être utilisés par les endpoints d’authentification pour générer d’autres identifiants, comme les jetons d’accès utilisateur et leurs secrets, ainsi que les jetons Bearer. Vous devez également utiliser ces identifiants avec des jetons d’accès et d’autres paramètres d’autorisation pour autoriser les requêtes qui nécessitent une authentification OAuth 1.0a dans un contexte utilisateur. 

Comment obtenir une clé et un secret d’API

Pour obtenir une clé et un secret d’API X, veuillez suivre les étapes suivantes :
  1. Inscrivez-vous pour créer un compte développeur X
  2. Créez une App X dans la Console de développement. Notez que si vous souhaitez utiliser X API v2, vous devez utiliser des clés et des jetons provenant d’une App développeur.  
Lorsque vous créez votre App X, votre clé et votre secret d’API vous sont fournis, ainsi qu’un Jeton Bearer. Veuillez noter que nous n’affichons ces identifiants qu’une seule fois, veillez donc à les enregistrer dans votre gestionnaire de mots de passe ou dans un endroit sécurisé. Vous trouverez davantage de recommandations sur la façon de gérer vos clés et vos jetons sur notre page consacrée aux bonnes pratiques d’authentification, qui inclut des détails sur ce que vous devez faire si vos identifiants ont été compromis.  

Comment retrouver et régénérer votre clé API et votre secret après la création de l’App

Si vous avez déjà créé une App et que vous devez retrouver ou régénérer votre clé API et votre secret, veuillez suivre ces étapes :
  1. Accédez à la Console de développement
  2. Développez le menu déroulant « Apps » dans la barre latérale de navigation
  3. Ouvrez l’App associée à la clé API et au secret que vous souhaitez retrouver ou régénérer
  4. Accédez à l’onglet « Keys and tokens »
Depuis cet emplacement, vous trouverez tous les identifiants associés à votre App.   

Comment utiliser votre clé et votre secret d’API

Si vous faites simplement vos premiers pas sur la plateforme développeur X, nous vous recommandons d’utiliser un outil ou une bibliothèque pour voir ce qui est disponible sur la plateforme. Ces outils gèrent l’authentification de manière transparente et peuvent vous faire gagner beaucoup de temps et vous éviter bien des frustrations. Nous recommandons en particulier de commencer avec Postman ou Insomnia pour les développeurs débutants.  Si vous souhaitez construire une requête à partir de zéro, veuillez consulter notre guide sur l’autorisation d’une requête OAuth 1.0a.