Passer au contenu principal

​
Vue d’ensemble

Le groupe de points de terminaison du flux filtré (filtered stream) permet aux développeurs de filtrer un flux de Publications publiques. Les fonctionnalités de ce groupe de points de terminaison incluent plusieurs endpoints qui vous permettent de créer et de gérer des règles, puis d’appliquer ces règles pour filtrer un flux de Publications renvoyant uniquement les Publications publiques correspondantes. Ce groupe de points de terminaison permet aux utilisateurs d’écouter des sujets et événements spécifiques, de suivre les conversations autour de compétitions, de comprendre comment les tendances se développent, et bien plus encore. Les développeurs peuvent utiliser le point de terminaison REST rules pour ajouter et supprimer des règles afin de filtrer les Publications correspondant à des critères définis. Ces règles peuvent être créées avec des opérateurs qui ciblent des attributs de la Publication tels que des mots-clés de message, des hashtags et des URL. Les opérateurs et les clauses de règle peuvent être combinés avec une logique booléenne et des parenthèses afin d’affiner le comportement de correspondance du filtre.  Une fois que vous avez ajouté un ensemble de règles, vous pouvez enregistrer votre webhook, à partir duquel X commencera à envoyer des objets Post au format JSON. Vous ne recevrez sur votre webhook que le contenu correspondant à vos règles. Ce point de terminaison prend en charge les Publications modifiées. Votre webhook recevra les Publications modifiées qui correspondent à un ou plusieurs de vos filtres, ainsi que leur historique de modification, y compris un tableau d’id de Publication. Pour les Publications sans historique de modification, ce tableau contiendra un seul id. Pour les Publications qui ont été modifiées, ce tableau contient plusieurs id, disposés dans l’ordre croissant reflétant l’ordre des modifications, la version la plus récente occupant la dernière position du tableau. Pour en savoir plus sur le fonctionnement des modifications de Publications, consultez la page Principes de base des modifications de Publications.  Remarque : Ce groupe de points de terminaison est similaire au point de terminaison filtered stream v2 pour la configuration de vos règles. La seule différence réside dans les mécanismes de livraison des Publications qui correspondent à vos règles.
  • Dans le cas du point de terminaison filtered stream v2, vous devez établir une connexion persistante et écouter les Publications qui correspondent à vos règles.
  • Dans le cas de ce point de terminaison filtered stream via webhook, vous enregistrez votre webhook et X envoie les Publications correspondant à vos règles à votre webhook.
Cela élimine la nécessité de gérer les déconnexions résultant de chutes côté client ou de chutes côté serveur dues aux redémarrages normaux de notre service. Comme nous livrerons probablement des centaines d’événements par seconde, il est nécessaire que votre serveur webhook soit capable de gérer ces tentatives de connexion simultanées. Ce point de terminaison est actuellement disponible pour les développeurs Enterprise et prend en charge la configuration suivante :
  • Plus de 25 000 règles par projet
  • Possibilité d’utiliser tous les opérateurs lors de la création de votre règle
  • Possibilité de créer des règles jusqu’à 2 048 caractères
  • Faites une demande ici pour obtenir un accès Enterprise
Les Publications renvoyées par filtered stream sont comptabilisées dans le plafond de Publications mensuel.
Configuration du comptePour accéder à ces points de terminaison, vous aurez besoin :Pour en savoir plus sur l’obtention de l’accès aux points de terminaison X API v2, consultez notre guide de démarrage.