Skip to main content

​
Recherche des comptes bloqués : standard v1.1 par rapport à X API v2

Si vous avez utilisé les endpoints standard v1.1 GET blocks/ids et GET blocks/list, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints de recherche de comptes bloqués standard v1.1 et X API v2.
  • Points communs
    • Authentification
  • Différences
    • URL des endpoints
    • Limites du nombre d’utilisateurs par requête
    • Exigences relatives aux App et aux Projets
    • Formats de données de réponse
    • Paramètres de requête

​
Similarités

Authentification Les endpoints de recherche des blocages des versions standard v1.1 et X API v2 utilisent tous deux OAuth 1.0a User Context. Par conséquent, si vous utilisiez auparavant l’un des endpoints de recherche des blocages standard v1.1, vous pouvez continuer à utiliser la même méthode d’authentification lors de votre migration vers la version X API v2. 

​
Différences

URLs des endpoints Limites d’utilisateurs par requête Les endpoints standard v1.1 vous permettent de retourner jusqu’à 5000 utilisateurs par requête. Les nouveaux endpoints v2 vous permettent de retourner jusqu’à 1000 utilisateurs par requête. Pour retourner un total de 1000 utilisateurs, vous devez passer max_results=1000 comme paramètre de requête ; vous pouvez ensuite passer le next_token renvoyé dans la charge utile de la réponse au paramètre de requête pagination_token dans votre requête suivante.   Exigences liées à l’App et au Project Les endpoints X API v2 exigent que vous utilisiez des identifiants provenant d’une developer App qui est associée à un Project lorsque vous authentifiez vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des identifiants provenant d’Apps ou d’Apps associées à un Project. Format des données de réponse L’une des plus grandes différences entre les versions d’endpoints standard v1.1 et X API v2 est la manière dont vous sélectionnez les champs qui sont renvoyés dans votre charge utile. Pour les endpoints standard, vous recevez de nombreux champs de réponse par défaut, puis vous avez la possibilité d’utiliser des paramètres pour indiquer quels champs ou quels ensembles de champs doivent être renvoyés dans la charge utile. La version X API v2 ne fournit par défaut que les champs user id, name et username. Pour demander des champs ou objets supplémentaires, vous devrez utiliser les paramètres fields et expansions. Tous les champs d’utilisateur que vous demandez depuis cet endpoint seront renvoyés dans l’objet utilisateur principal. Tout objet Publication étendu et ses champs seront renvoyés dans un objet includes au sein de votre réponse. Vous pouvez ensuite faire correspondre les objets étendus à l’objet utilisateur en faisant correspondre les id présents à la fois dans l’utilisateur et dans l’objet Publication étendu.  Nous vous encourageons à en savoir plus sur ces nouveaux paramètres dans leurs guides respectifs, ou en lisant notre guide sur la façon d’utiliser les fields et expansions.  Nous avons également rédigé un guide de migration de format de données qui peut vous aider à mapper les champs standard v1.1 vers les nouveaux champs v2. Ce guide vous fournira également le paramètre expansions et fields spécifique que vous devrez passer avec votre requête v2 pour retourner des champs précis.    En plus des changements dans la manière dont vous demandez certains champs, X API v2 introduit également de nouveaux modèles JSON pour les objets renvoyés par les API, y compris les objets Publication et user.
  • Au niveau racine JSON, les endpoints standard renvoient des objets Publication dans un tableau statuses, tandis que X API v2 renvoie un tableau data. 
  • Au lieu de faire référence à des « statuses » Retweeted et Quoted, le JSON X API v2 fait référence à des Tweets Retweeted et Quoted. De nombreux champs hérités et obsolètes, tels que contributors et user.translator_type, sont supprimés. 
  • Au lieu d’utiliser à la fois favorites (dans l’objet Publication) et favourites (dans l’objet user), X API v2 utilise le terme like. 
  • X adopte la convention selon laquelle les valeurs JSON sans valeur (par exemple null) ne sont pas écrites dans la charge utile. Les attributs de Publication et d’utilisateur ne sont inclus que s’ils ont des valeurs non nulles.   
Nous avons également introduit un nouvel ensemble de champs dans l’objet Publication, notamment :
  • Un champ conversation_id
  • Deux nouveaux champs annotations, notamment context et entities
  • Plusieurs nouveaux champs metrics 
  • Un nouveau champ reply_setting, qui vous indique qui peut répondre à une Publication donnée
Paramètres de requête Les paramètres de requête standard de la v1.1 suivants acceptaient deux paramètres de requête (user_id ou screen_name). L’X API v2 n’accepte que l’identifiant utilisateur numérique, qui doit être fourni dans le chemin de l’endpoint.

​
Exemples de code

​
Récupérer les utilisateurs bloqués (v2)

cURL
curl "https://api.x.com/2/users/123456789/blocking?user.fields=username,verified&max_results=100" \
  -H "Authorization: OAuth ..."

​
Bloquer un utilisateur (v2)

cURL
curl -X POST "https://api.x.com/2/users/123456789/blocking" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'