Introduction

Le groupe de points de terminaison de l’API X Activity (XAA) permet aux développeurs d’accéder aux événements d’activité se produisant sur la plateforme X.

Un développeur peut s’abonner aux événements qui l’intéressent, tels que ProfileBioUpdate, ProfilePictureUpdate, etc., et filtrer sur l’ID utilisateur pour lequel il souhaite recevoir des événements. Les événements correspondants pour cet ID utilisateur seront délivrés à votre application avec une latence inférieure à la seconde.

L’API X Activity est disponible en bêta ouverte. Durant cette phase, attendez-vous à d’éventuels bogues, changements incompatibles ou fonctionnalités incomplètes.

Vos retours sont précieux — signalez les problèmes via nos forums de la communauté des développeurs.

​

Mécanismes de livraison

L’API X Activity prend actuellement en charge les mécanismes de livraison suivants pour envoyer des événements à votre application :

• Flux HTTP persistant
• Webhook

​

Types d’événements pris en charge

Actuellement, l’API X Activity prend en charge les événements de mise à jour de profil suivants :

Catégorie	Nom de l’événement	Description
Profil	ProfileBioUpdate	Déclenché lorsqu’un utilisateur met à jour la bio de son profil
Profil	ProfilePictureUpdate	Déclenché lorsqu’un utilisateur met à jour la photo de profil
Profil	ProfileBannerUpdate	Déclenché lorsqu’un utilisateur met à jour la bannière de profil
Profil	ProfileGeoUpdate	Déclenché lorsqu’un utilisateur met à jour la localisation de son profil
Profil	ProfileUrlUpdate	Déclenché lorsqu’un utilisateur met à jour l’URL du site web de son profil
Profil	ProfileScreennameUpdate	Déclenché lorsqu’un utilisateur met à jour son nom d’affichage
Profil	ProfileVerifiedBadgeUpdate	Déclenché lorsqu’un utilisateur met à jour son badge de vérification

Dans de prochaines versions, XAA sera étendu pour prendre en charge des types d’événements supplémentaires, notamment les interactions sociales, l’engagement de contenu, les fonctionnalités de monétisation, et plus encore. Nous continuerons à mettre à jour notre documentation lorsque de nouveaux types d’événements seront disponibles.

Remarque : XAA ne livre pas de Publications. Pour la livraison de Publications en temps réel, consultez notre point de terminaison Filtered Stream, qui permet aux développeurs de filtrer et de diffuser des Publications en temps réel.

​

Confidentialité des événements et authentification

L’API X Activity distingue les événements publics et les événements privés, conformément à l’application X, comme expliqué ci-dessous.

​

Événements publics

Les événements publics correspondent aux activités qu’un compte utilisateur public réalise de manière visible par tous les utilisateurs de X. Ces événements sont accessibles à l’ensemble des utilisateurs sur la plateforme X et ne nécessitent pas d’authentification OAuth de la part de l’utilisateur pour être consultés.

Événements publics actuels :

• Mises à jour du profil (bio, photo, bannière, lieu, URL, modification du nom d’utilisateur)

Pour ces événements publics, vous pouvez créer des abonnements en spécifiant l’id de l’utilisateur dans votre filtre et les recevoir via XAA.

​

Événements privés

Les événements privés sont des activités qui nécessitent le consentement explicite de l’utilisateur via une authentification OAuth. Un utilisateur doit s’authentifier via X et donner une autorisation explicite à une App développeur pour accéder à ces événements.

Exigences d’authentification pour les événements privés :

• L’utilisateur doit authentifier votre application via OAuth 2.0
• Votre application doit obtenir les autorisations (scopes) OAuth appropriées
• L’utilisateur doit accorder explicitement l’autorisation à votre App d’accéder à ces événements
• Les abonnements aux événements privés ne peuvent être créés que pour les utilisateurs qui ont autorisé votre application

​

Limites d’abonnement

L’API X Activity applique des limites d’abonnement différentes selon votre niveau de compte :

Niveau de formule	Nombre maximal d’abonnements
Free	Non disponible
Basic	50
Pro	2500
Enterprise	20 000
Partner	100 000

Configuration du compte

Pour accéder à ces points de terminaison, vous aurez besoin :

• D’un compte développeur approuvé.
• De vous authentifier à l’aide des clés et jetons d’une App développeur située dans un Project.

Pour en savoir plus sur l’accès aux points de terminaison de la X API v2, consultez notre guide de démarrage.