Passer au contenu principal

​
Vue d’ensemble

Le groupe d’endpoints du flux filtré permet aux développeurs de filtrer un stream de Posts publics. Les fonctionnalités de ce groupe d’endpoints incluent plusieurs endpoints qui vous permettent de créer et de gérer des règles, et d’appliquer ces règles pour filtrer un stream de Posts afin de renvoyer les Posts publics correspondants. Ce groupe d’endpoints permet aux utilisateurs d’écouter des sujets et des événements spécifiques, de surveiller la conversation autour de compétitions, de comprendre l’évolution des tendances, et bien plus encore. Les développeurs peuvent utiliser l’endpoint REST rules pour ajouter et supprimer des règles afin de filtrer les Posts correspondant à des critères définis. Ces règles peuvent être créées avec des opérateurs qui ciblent des attributs de Post tels que des mots-clés, 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 pour 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 à livrer des Objets Post au format JSON. Vous ne recevrez sur votre webhook que le contenu correspondant à vos règles. Cet endpoint prend en charge les Posts modifiés. Votre webhook recevra des Posts modifiés qui correspondent à un ou plusieurs de vos filtres, ainsi que leur historique des modifications, incluant un tableau d’ID de Post. Pour les Posts sans historique de modification, ce tableau contiendra un seul ID. Pour les Posts qui ont été modifiés, ce tableau contient plusieurs ID, classés par ordre croissant reflétant l’ordre des modifications, avec la version la plus récente en dernière position. Pour en savoir plus sur le fonctionnement des modifications de Post, consultez la page Posts edits fundamentals. Remarque : Ce groupe d’endpoints est similaire à l’endpoint de flux filtré v2 pour la configuration de vos règles. La seule différence réside dans les mécanismes de livraison des Posts correspondant à vos règles.
  • Dans le cas de l’endpoint de flux filtré v2, vous devez établir une connexion persistante et écouter les Posts correspondant à vos règles.
  • Dans le cas de cet endpoint de webhook de flux filtré, vous enregistrez votre webhook, et X livre les Posts correspondant à vos règles à votre webhook.
Cela élimine la nécessité de gérer les déconnexions dues à des chutes côté client ou à des interruptions côté serveur lors des redémarrages normaux de notre service. Étant donné que nous livrerons probablement des centaines d’événements par seconde, il est nécessaire que votre serveur de webhook soit capable de gérer ces tentatives de connexion simultanées. Cet endpoint est actuellement disponible pour les développeurs Enterprise et prend en charge la configuration suivante :
  • Plus de 25 000 règles par Project
  • 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
  • Demandez l’accès ici pour Enterprise
Les Posts renvoyés par le flux filtré sont comptabilisés dans le Post cap mensuel.
Configuration du comptePour accéder à ces endpoints, vous aurez besoin de :Pour en savoir plus sur l’accès aux endpoints X API v2, consultez notre guide de démarrage.
⌘I