Passer au contenu principal
X s’engage auprès de notre communauté de développeurs qui créent avec la X API. Dans le cadre de cet engagement, nous visons à rendre notre API ouverte et équitable pour les développeurs, sûre pour les personnes sur X et bénéfique pour la plateforme X dans son ensemble. Il est crucial que tout développeur qui stocke du contenu X hors ligne s’assure que les données reflètent l’intention des utilisateurs et l’état actuel du contenu sur X. Par exemple, lorsqu’une personne sur X supprime un Post ou son compte, protège ses Posts ou efface les informations de géolocalisation de ses Posts, il est essentiel, pour X comme pour nos développeurs, de respecter les attentes et l’intention de cette personne. Les endpoints de conformité par lot offrent aux développeurs un outil simple pour aider à maintenir les données de X en conformité avec le X Developer Agreement and Policy.  Ces endpoints de conformité par lot vous permettent de téléverser de grands jeux de données d’ID de Post ou d’utilisateurs afin de récupérer leur statut de conformité et ainsi déterminer quelles données nécessitent une action pour mettre vos jeux de données en conformité. Veuillez noter que l’utilisation des endpoints de conformité par lot est limitée aux cas d’usage susmentionnés, et que toute autre finalité est interdite et peut entraîner des mesures d’application. En général, 4 étapes sont impliquées lors de l’utilisation de cet endpoint :
  1. Créer une tâche de conformité Vous pouvez spécifier le type de tâche (avec la valeur tweets ou users) pour indiquer si le jeu de données que vous souhaitez téléverser contient des ID de Post ou des ID d’utilisateurs. Vous pouvez avoir une tâche simultanée par type de tâche à tout moment.
  2. Téléverser votre jeu de données vers l’upload_url Ensuite, vous téléversez votre jeu de données sous forme de fichier texte brut vers l’upload_url fournie, chaque ligne du fichier contenant un seul ID de Post ou un ID d’utilisateur. L’upload_url expire au bout de 15 minutes.
  3. (Optionnel) Vérifier l’état de la tâche Vous pouvez vérifier l’état de votre tâche de conformité pour voir si elle est created, in_progress, failed ou complete.
  4. Télécharger les résultats Lorsque votre tâche est terminée, vous pouvez télécharger les résultats à l’aide de la download_url. La download_url expire après une semaine (à partir de la création de la tâche). Ce résultat contiendra un ensemble d’objets JSON (un objet par ligne). Chaque objet contiendra un ID de Post, la date de création du Post (utile pour retrouver des Posts organisés par date), l’action requise, la raison de l’action de conformité et la date de suspension de l’utilisateur.
Vous recevrez les types d’événements de conformité suivants dans vos résultats :
  • deleted - indique que le Post ou le compte Utilisateur a été supprimé
  • deactivated - indique que le Post ou le compte Utilisateur a été désactivé
  • scrub_geo - indique que les informations de géolocalisation associées au Post ou à l’Utilisateur ont été supprimées
  • protected - indique que le compte ayant créé le Post est devenu privé
  • suspended - indique que le compte ayant créé le Post a été suspendu
Configuration du compte Pour accéder à ces endpoints, vous aurez besoin de : En savoir plus sur l’accès aux endpoints de la X API v2 dans notre guide de démarrage.
⌘I