Comment générer un jeton d'accès personnel

Chaque demande adressée à l'API Vimeo nécessite un jeton d'authentification. Le jeton d'authentification nous indique qui est à l'origine de la demande et les actions que l'utilisateur peut effectuer. Cet article explique comment générer un jeton d'authentification pour l'API Vimeo.

Sommaire de l'article :

• Ce qu'il faut savoir avant de générer un jeton d'accès personnel
• Comment générer un jeton d'accès personnel
• Suggestions de prochaines étapes

Ce qu'il faut savoir avant de générer un jeton d'accès personnel

• Pour commencer, vous devez créer une application API dans notre page de développeur. C'est ce qui interagit avec l'API et demande l'authentification. Découvrez comment en créer une sur cette page Comment créer une application API
• Un jeton d'accès personnel est un code unique utilisé pour authentifier vos demandes d'API. 
• Ce jeton peut être « authentifié », ce qui signifie qu'il est associé à votre compte Vimeo et qu'il peut accéder aux métadonnées privées de votre compte et de vos vidéos, ou « Non authentifié », ce qui signifie qu'il n'est autorisé que pour votre application API et qu'il ne peut être utilisé que pour lire les métadonnées qui est public sur Vimeo.com. 
• Si vous avez besoin que d'autres utilisateurs accordent à votre application l'accès à leurs comptes Vimeo, un jeton d'accès doit être généré à l'aide d'un de nos autres workflows d'authentification disponibles. 
  • Une documentation complète sur nos workflows d'authentification est disponible sur notre site de développeur à l'adresse « Travailler avec l'authentification ». 
• Protégez votre jeton. Toute personne disposant d'un accès peut l'utiliser pour faire des demandes au nom de votre application ou de votre compte.

Comment générer un jeton d'accès personnel

Vous pouvez générer un jeton d'accès personnel à partir de la page Applications sur Vimeo. Pour ce faire : 

1. Rendez-vous sur votre page Applications.
2. Sélectionnez l'application avec laquelle vous souhaitez vous authentifier, ou créez une application si vous ne l'avez pas encore fait.
3. Sélectionnez Générer un jeton d'accès dans la colonne de navigation de gauche, sous l'en-tête Authentification. 
   
4. Sélectionnez Authentifié (vous) si vous devez interagir avec des données privées sur votre compte. Sélectionnez Non authentifié si vous avez uniquement besoin de lire les métadonnées publiques.

5. Si vous sélectionnez Authentifié, alors sous l'en-tête Portées, vérifiez les capacités que vous souhaitez accorder au jeton. Vous trouverez les définitions de ces portées sur notre Site développeur. 
   • ⚠️Remarque : pour accéder aux vidéos non publiques ou aux métadonnées non publiques, vous devez sélectionner le champ « Privé » en plus des autres champs dont vous avez besoin. Si vous choisissez uniquement « public », vous ne pourrez pas accéder aux informations privées.
     
6. Sélectionnez Générer. La page sera actualisée et le jeton apparaîtra en clair dans la section Jetons d'accès personnels.
7. Copiez la chaîne du jeton et stockez-la dans un endroit sécurisé. Ce jeton peut être utilisé dans vos scripts ou vos applications pour interagir avec l'API Vimeo.

Suggestions de prochaines étapes

Consultez nos documents développeur pour en savoir plus sur l'authentification.