Comparaison des endpoints de flux filtrés de X API
| Description | Standard v1.1 | API PowerTrack | X API v2 |
|---|---|---|---|
| Accès | App X | Nécessite un contrat et un compte entreprise | Nécessite un compte développeur (s’inscrire) ainsi qu’une App X au sein d’un Project |
| :--- | :--- | :--- | :--- |
| Domaine de l’hôte | https://stream.x.com | https://gnip-stream.x.com | https://api.x.com |
| Chemin de l’endpoint | 1.1/statuses/filter.json | /stream/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter//validation.json | /2/tweets/search/stream /2/tweets/search/stream/rules |
| Authentification | Contexte utilisateur OAuth 1.0a | Authentification HTTP Basic | OAuth 2.0 App-only |
| Méthodes HTTP prises en charge | POST | GET POST | GET POST |
| Paramètres requis | Règle définie pour la connexion sous forme de paramètre, au moins l’un des éléments suivants : * follow * track * locations | Aucun paramètre requis pour la connexion en streaming, paramètre de rattrapage facultatif. Règles gérées séparément | Aucun paramètre requis pour la connexion de streaming, paramètres optionnels pour définir le format de réponse et ajouter la fonctionnalité de rattrapage des données manquées (backfill) pour l’accès Academic Research. Règles gérées séparément. |
| Type de diffusion | Streaming | Streaming REST (pour la gestion des règles) | Streaming REST (pour la gestion des règles) |
| Limites de taux de requêtes par défaut | 5 tentatives de connexion toutes les 5 minutes | 60 requêtes par minute, cumulées pour les requêtes POST et GET /rules : 60 requêtes par minute, cumulées pour l’ensemble des requêtes adressées au point de terminaison /rules de l’API du flux concerné (POST et GET). | Selon l’endpoint. Voir limites de taux pour les limites actuelles. |
| Nombre maximal de connexions autorisées | 2 connexions simultanées par utilisateur autorisé | Prend en charge plusieurs connexions redondantes, déterminées par contrat | Facturation à l’usage : 1 |
| Fonctionnalités de reprise et de redondance | Aucune | Rétro-remplissage (backfill), connexions redondantes et API Replay | |
| Signal de maintien en vie / battements (heartbeats) | Lignes vides (\r\n ou similaire) au moins toutes les 20 secondes | Lignes vides (\r\n ou similaire) toutes les 10 secondes | Lignes vides (\r\n ou similaire) au moins toutes les 20 secondes |
| Latence | 10 secondes | 2 secondes Au moins 10 secondes pour l’enrichissement de résolution des URL | 10 secondes |
| Nombre maximal de règles autorisées | 1 règle (dans la requête de connexion à l’endpoint) | Déterminé par contrat, jusqu’à 250 000 | Facturation à l’usage : 1 000 règles |
| Limitations des filtres de règles | Une requête par connexion, jusqu’à l’une des limites suivantes : - 400 mots-clés de suivi - 5 000 identifiants d’utilisateurs suivis - 25 zones géographiques | Jusqu’à 2 048 caractères par règle | Paiement à l’usage : 1 à 24�a0caractères par règle |
| Format JSON de Publication | Format standard v1.1 | Native Enriched ou Activity Streams (à sélectionner dans la console) | Format X API v2 (défini par les paramètres de requête fields et expansions, non rétrocompatible avec les formats v1.1) Pour en savoir plus sur la migration du format Standard v1.1 vers le format X API v2, consultez notre guide de migration des formats de données. Nous publierons prochainement d’autres guides de migration des formats de données pour Native Enriched et Activity Streams. |
| Fournit l’historique des modifications de la Publication ainsi que ses métadonnées | ✔ | ✔ | ✔ |
| Fonctionnalités uniques | Filtrage effectué à l’aide de paramètres de requête sur la requête de connexion Aucune interface de configuration | Filtrage effectué au moyen de règles créées via un endpoint distinct Fonctionnalités d’enrichissement disponibles dans le contrat Configuration dans l’interface utilisateur console.gnip.com | Filtrage effectué au moyen de règles créées via un endpoint distinct Fonctionnalités Metrics et d’enrichissement d’URL incluses champs d’objet et Expansions spécifiés via des paramètres de requête Annotations de Publication Opérateur et champ Conversation ID Configuration via la Console de développement |