Ressources importantes
- Obtenir l’accès à X API v2
- Dictionnaire des données Spaces
- Effectuer votre première requête vers un endpoint Spaces
Spaces
Introduction
La page suivante décrit les endpoints Spaces inclus dans la X API. Pour en savoir plus sur Spaces en général, veuillez consulter help.x.com.
Spaces permettent l’expression et l’interaction via des conversations audio en direct. Les endpoints Spaces fournissent des outils pour créer de nouvelles fonctionnalités autour de Spaces. Vous pouvez utiliser ces endpoints pour rechercher des Spaces en direct ou programmés, ou pour créer des expériences de découverte afin d’offrir à vos utilisateurs des moyens de trouver des Spaces susceptibles de les intéresser.
Nous vous encourageons à faire preuve de créativité pour étendre Spaces au-delà de la manière dont nous l’avons conçu. Avec ces endpoints, vous pouvez créer des expériences pour suggérer des Spaces aux auditeurs en fonction des mots-clés présents dans le title, ou en mettant en avant des comptes qui hébergent des Spaces en direct ou à venir et qui sont suivis par un utilisateur ; vous pouvez également aider les hôtes à mieux comprendre les performances de leurs Spaces et à obtenir davantage d’informations sur leur audience.
Les ressources suivantes vous aideront à démarrer et à intégrer les endpoints Spaces :
Contrairement à d’autres ressources de la X Developer Platform, les Spaces suivent un cycle de vie défini. Ils peuvent être planifiés jusqu’à 14 jours avant leur date de début prévue et deviennent indisponibles une fois qu’ils se terminent. Un hôte peut également annuler un Space programmé à tout moment avant son démarrage.
Les Spaces sont accessibles lorsqu’ils sont en direct ; une fois terminés, ils ne sont plus disponibles via les endpoints Spaces et un message d’erreur est renvoyé pour l’indiquer.
Lorsque votre App traite des data de Spaces, vous êtes responsable de retourner les informations les plus à jour et de supprimer les données qui ne sont plus disponibles sur la plateforme. L’endpoint de recherche de Spaces peut vous aider à veiller au respect des attentes et de l’intention de vos utilisateurs.
Ces endpoints reflètent la manière dont les Spaces fonctionnent dans l’App X. Dans Spaces, les utilisateurs de X peuvent se voir attribuer des rôles selon leur façon d’interagir avec un Space et d’y participer.
L’hôte principal est l’utilisateur qui a créé un Space et le propriétaire du Space lui-même. Actuellement, les Spaces ne peuvent avoir qu’un seul hôte ; l’hôte principal est donc le seul hôte. Dans le dictionnaire de données Spaces, les informations sur l’hôte principal figurent dans le champ creator_id, qui peut être développé en un objet utilisateur.
Les hôtes principaux peuvent désigner un ou plusieurs utilisateurs comme co‑hôtes. Dans le dictionnaire de données Spaces, ces hôtes apparaissent sous forme de host_ids, qui peuvent être étendus en une liste d’objets utilisateur. La désignation d’hôte peut évoluer au cours d’un Space, et les metadata renvoyées par ces endpoints refléteront l’état au moment de la requête.
Votre App identifiera l’hôte principal en vérifiant la valeur de creator_id, et les co‑hôtes en vérifiant les valeurs de host_ids.
Les intervenants sont des utilisateurs autorisés à prendre la parole dans l’Espace. Zéro ou plusieurs intervenants peuvent être présents à tout moment, et un Espace peut en compter jusqu’à 10 (hôtes inclus). Dans le dictionnaire de data de l’Espace, les intervenants seront renvoyés dans la liste speaker_ids, que vous pouvez développer en une liste d’objets utilisateur.
Un Listener peut écouter un Space, réagir à tout moment à l’aide des réactions prédéfinies et demander à devenir speaker (lorsque les Hosts l’autorisent dans les paramètres du Space). Les informations sur les Listeners ne seront renvoyées que sous forme de décompte agrégé des participants (y compris les Hosts) dans le champ participant_count.
⌘I