Passer au contenu principal
La page suivante décrit les endpoints Spaces inclus dans l’X API. Pour en savoir plus sur Spaces en général, veuillez consulter help.x.com Spaces permet l’expression et l’interaction via des conversations audio en direct. Les endpoints Spaces fournissent les outils nécessaires 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 façon dont nous l’avons conçu. Avec ces endpoints, vous pouvez créer des expériences suggérant des Spaces aux auditeurs en fonction des mots‑clés présents dans le titre, 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.

Ressources importantes

Les ressources suivantes vous aideront à démarrer et à intégrer les endpoints Spaces :

Ce qui est actuellement disponible

Comprendre le cycle de vie des Spaces

Contrairement aux autres ressources de la X Developer Platform, les Spaces ont un cycle de vie spécifique. Les Spaces peuvent être planifiés jusqu’à 14 jours avant leur date de début prévue et deviennent indisponibles une fois terminés. Un hôte peut également annuler un Space précédemment planifié à tout moment avant son début. Les Spaces sont accessibles lorsqu’ils sont en direct : une fois terminés, ils ne seront plus disponibles pour la consultation via les endpoints Spaces, et un message d’erreur sera renvoyé pour indiquer cette situation. Lorsque votre application traite des données de Spaces, vous êtes responsable de renvoyer les informations les plus récentes et de supprimer les données qui ne sont plus disponibles sur la plateforme. Le Spaces lookup endpoint peut vous aider à vous assurer que vous respectez les attentes et l’intention de vos utilisateurs.  

Rôles dans les Spaces

Ces endpoints reflètent le fonctionnement des Spaces dans l’App X. Dans les Spaces, les utilisateurs X peuvent avoir des rôles définis selon la manière dont ils interagissent avec un Space et y participent.  

Créateur (ou hôte principal)

L’hôte principal est l’utilisateur qui a créé un Space et en est le propriétaire. Actuellement, un Space ne peut avoir qu’un seul hôte ; l’hôte principal est donc l’unique hôte. Dans le dictionnaire de données Spaces, les informations relatives à l’hôte principal se trouvent dans le champ creator_id, qui peut être étendu en un objet user.  

Hôtes

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 la forme de host_ids, qui peuvent être étendus en une liste d’objets user. La désignation d’hôte peut changer pendant la durée d’un Space, et les métadonnées renvoyées par ces points de terminaison refléteront l’état au moment de la requête. Votre App pourra identifier l’hôte principal en vérifiant la valeur creator_id, et les co‑hôtes en vérifiant les valeurs host_ids.  

Intervenant

Les intervenants sont des utilisateurs qui ont l’autorisation de parler dans un Space. Zéro ou plusieurs intervenants peuvent être présents à un moment donné, et il peut y avoir jusqu’à 10 intervenants (y compris les hôtes) dans un Space. Dans le dictionnaire de données des Spaces, les intervenants sont renvoyés dans la liste speaker_ids, que vous pouvez développer pour en faire une liste d’objets utilisateur.  

Auditeur

Un auditeur peut écouter un Space, réagir à tout moment en utilisant les réactions prédéfinies et demander à devenir intervenant (lorsque les hôtes l’autorisent dans les paramètres du Space). Les informations relatives aux auditeurs ne sont renvoyées que sous la forme d’un décompte agrégé des participants (y compris les hôtes) dans le champ participant_count.