Passer au contenu principal

Introduction

Les Projects vous permettent d’organiser votre travail en fonction de la manière dont vous prévoyez d’utiliser la X API, afin de gérer efficacement votre accès à l’API et de surveiller votre utilisation. Chaque Project peut contenir une ou plusieurs Apps selon votre niveau d’accès (décrit plus loin sur cette page). Vous utiliserez ces Apps pour générer des informations d’authentification telles que des API Keys and Secrets, des Access Tokens utilisateur et un App Access Token. Bien que vous puissiez utiliser ces clés et jetons depuis n’importe quelle App pour accéder à la X API ou à la X Ads API (vous devez demander un accès supplémentaire pour utiliser la X Ads API), vous devez utiliser des clés et jetons provenant d’une App associée à un Project pour pouvoir utiliser les endpoints de la X API v2. Si vous avez un compte développeur, vous pouvez consulter et gérer vos Projects sur la page Projects & Apps dans le developer portal. Inscrivez-vous pour obtenir un compte si vous n’en avez pas encore.

Projets et niveaux d’accès à la X API

Pour le moment, 4 niveaux d’accès différents sont appliqués au niveau du Project :
  • Free
  • Basic
  • Pro
  • Enterprise
Pour en savoir plus sur ce que propose chacun de ces niveaux d’accès, veuillez consulter la page À propos de la X API. Vous ne pouvez avoir qu’un seul Project avec le niveau Free, Basic ou Pro. Nous présenterons ici quelques différences spécifiques au Project :

Gratuit

Ce niveau d’accès est proposé à toute personne qui s’est inscrite à un compte développeur. Nombre d’Apps dans ce Project : 1 Plafond de consommation de Tweets : 1 500 Tweets par mois Méthodes d’authentification :

Basic

Ce niveau d’accès est disponible pour toute personne ayant souscrit à l’accès Basic via le developer portal. Nombre d’Apps dans ce Project : 2 Tweet consumption cap : 10 000 Tweets par mois Méthodes d’authentification :

Pro

Ce niveau d’accès est disponible pour toute personne ayant souscrit un accès Pro via le developer portal. Nombre d’Apps dans ce Project : 3 Plafond de consommation des Tweets : 1 million de Tweets par mois Méthodes d’authentification :

Enterprise

Ce niveau d’accès est proposé à toute personne ayant demandé l’accès Enterprise, ayant été approuvée par notre équipe et ayant signé un contrat mensuel à renouvellement automatique via un account manager X. Postulez ici. Nombre d’Apps au sein de ce Project : 3+ Plafond de consommation de Tweets : plus de 50 millions de Tweets par mois Méthodes d’authentification :

Plafonds de Tweets et Projects

Les plafonds de consommation de Tweets s’appliquent au niveau du Project, limitant le volume de Tweets que vous pouvez récupérer à partir de certains endpoints de la X API v2 au cours d’un mois donné. En savoir plus sur les plafonds de Tweets.

Configuration des Projects

Création d’un Project

Pour créer un Project, cliquez sur « New Project » dans votre dashboard ou sur la page Projects & Apps du developer portal. Cette option n’apparaît que si vous n’avez pas encore créé de Project. Il vous sera demandé de saisir un nom de Project, une description et un cas d’usage. Il vous sera également demandé de créer une nouvelle App ou de connecter une App autonome existante.

Création ou connexion d’une App à votre Project

Si votre Project ne comprend pas d’App, vous pouvez en ajouter une en cliquant sur le nom du Project dans le tableau de bord. À partir de là, vous pouvez soit créer une nouvelle App, soit sélectionner une App autonome existante à connecter à votre Project. L’App est l’endroit où vous pouvez générer les clés et jetons d’authentification mentionnés au début de ce guide.

Modification d’un Project

Pour modifier un Project, cliquez sur le nom de votre Project depuis le tableau de bord ou la page Projects & Apps du developer portal. À partir de là, vous verrez les détails de votre Project et pourrez sélectionner « edit » pour effectuer des modifications.

Applications autonomes

Les Applications autonomes sont des Apps qui existent en dehors de la structure du Project. Les identifiants d’authentification associés à ces Applications autonomes peuvent envoyer des requêtes avec succès vers les offres Standard v1.1, premium v1.1, Enterprise de la X API, ou vers la X Ads API. Les Applications autonomes échoueront lorsqu’elles tenteront d’envoyer des requêtes vers les endpoints de la X API v2, sauf si vous les connectez à un Project. Si vous avez créé une App avant août 2020, elle sera visible dans la section « Standalone Apps » du developer portal sous Projects & Apps. Vous serez limité à dix Apps au total, y compris celles qui sont connectées à votre Project. Si vous faites partie d’un compte d’équipe, vous verrez les Apps que vous possédez sous Standalone Apps. Si un membre de l’équipe possède une App qui fait partie d’un Project, vous pourrez voir le nom de l’App et les informations sur le propriétaire, mais vous ne pourrez pas modifier ses paramètres, accéder à ses clés et jetons, ni régénérer ses clés et jetons. Vous devez contacter le propriétaire de l’App pour apporter des modifications à son App.
I