Recherche des comptes mis en sourdine

Recherche de comptes en sourdine : Standard v1.1 par rapport à X API v2

Si vous avez utilisé les endpoints standard v1.1 GET mutes/users/ids et GET mutes/users/list, l’objectif de ce guide est de vous aider à comprendre les similitudes et les différences entre les endpoints de recherche de comptes en sourdine du standard v1.1 et de X API v2.

• Similitudes
  • Authentification
• Différences

  • URL des endpoints

  • Limites du nombre d’utilisateurs par requête

  • Exigences relatives aux App et aux Projets

  • Formats des données de réponse

  • Paramètres de requête

Points communs

Authentification

Les endpoints de recherche des comptes mis en sourdine, tant en standard v1.1 que dans X API v2, utilisent OAuth 1.0a User Context. Par conséquent, si vous utilisiez auparavant l’un des endpoints standard v1.1 de recherche des comptes mis en sourdine, vous pouvez continuer à utiliser la même méthode d’authentification si vous migrez vers la version X API v2. 

Différences

URL des endpoints

• Endpoints standard v1.1 :
  • GET https://api.x.com/1.1/mutes/users/ids.json (liste des id d’utilisateurs que l’utilisateur spécifié a mis en sourdine)
  • GET https://api.x.com/1.1/mutes/users/lists.json (liste des utilisateurs mis en sourdine par l’utilisateur spécifié)
• Endpoint X API v2 :
  • GET https://api.x.com/2/users/:id/muting (liste des utilisateurs mis en sourdine par l’id d’utilisateur spécifié)  

Limites d’utilisateurs par requête

Les endpoints standard v1.1 vous permettent de renvoyer jusqu’à 5000 utilisateurs par requête. Les nouveaux endpoints v2 vous permettent de renvoyer jusqu’à 1000 utilisateurs par requête. Pour renvoyer un total de 1000 utilisateurs, vous devez transmettre max_results=1000 comme paramètre de requête ; vous pouvez ensuite transmettre le next_token renvoyé dans le corps de la réponse au paramètre de requête pagination_token dans votre requête suivante.  

Exigences pour les App et les Projets

Les endpoints X API v2 exigent que vous utilisiez des identifiants provenant d’une App développeur associée à un Projet lors de l’authentification de vos requêtes. Tous les endpoints X API v1.1 peuvent utiliser des identifiants provenant d’Apps ou d’Apps associées à un projet.

Format des données de réponse

L’une des plus grandes différences entre les versions de endpoints standard v1.1 et X API v2 concerne la façon dont vous sélectionnez les champs renvoyés dans votre charge utile.

Pour les endpoints standard, vous recevez un grand nombre de champs de réponse par défaut, puis vous avez la possibilité d’utiliser des paramètres pour identifier quels champs ou 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 devez utiliser les paramètres champs et expansions. Tous les champs utilisateur que vous demandez à partir de ce 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 tout objet étendu à l’objet utilisateur en faisant correspondre les id présents 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 comment utiliser les champs et les expansions. 

Nous avons également préparé un guide de migration de format de données qui peut vous aider à faire correspondre les champs standard v1.1 aux nouveaux champs v2. Ce guide vous fournit également le paramètre d’expansion et de champ spécifique que vous devrez transmettre avec votre requête v2 pour renvoyer des champs spécifiques.   

En plus des changements concernant la façon dont vous demandez certains champs, X API v2 introduit également de nouvelles conceptions JSON pour les objets renvoyés par les API, y compris les objets Publication et utilisateur.

• Au niveau racine du 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 aux « statuses » Retweeted et Quoted, le JSON X API v2 fait référence aux 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 utilisateur), X API v2 utilise le terme like. 
• X adopte la convention selon laquelle les champs JSON sans valeur (par exemple null) ne sont pas écrits dans la charge utile. Les attributs de Publication et d’utilisateur ne sont inclus que s’ils ont une valeur non nulle.   

Nous avons également introduit un nouvel ensemble de champs dans l’objet Publication, notamment les éléments suivants :

• Un champ conversation_id
• Deux nouveaux champs annotations, notamment context et entities
• Plusieurs nouveaux champs métriques 
• 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 v1.1 suivants ont des équivalents dans X API v2 :

Standard	X API v2
stringify_ids	Aucun équivalent
cursor	pagination_token
skip_status	Aucun équivalent

Il existe également un ensemble de paramètres standard de requête de recherche de Mutes v1.1 non pris en charge dans X API v2 :

Standard	Commentaire
include_entities	Ce paramètre est utilisé pour supprimer le nœud entities de la charge utile de la Publication. Il a été remplacé par des champs additifs et la fonctionnalité d’expansions.

---

Exemples de code

Récupérer les comptes masqués (v2)

cURL

shellscript

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