Guide d’intégration

Concepts clés et bonnes pratiques pour l’intégration des endpoints de mise en sourdine

Ce guide couvre les concepts clés dont vous avez besoin pour intégrer les endpoints de masquage dans votre application.

---

​

Authentification

Les endpoints Mutes requièrent une authentification utilisateur pour accéder aux listes de mise en sourdine privées :

Méthode	Description
OAuth 2.0 Authorization Code with PKCE	Recommandé pour les nouvelles applications
OAuth 1.0a User Context	Support hérité

L’authentification App-Only n’est pas prise en charge. Vous devez vous authentifier au nom d’un utilisateur.

​

Scopes requis (OAuth 2.0)

Scope	Obligatoire pour
mute.read	Récupérer les comptes masqués
mute.write	Masquer et ne plus masquer des comptes
users.read	Obligatoire avec les scopes de masquage

---

​

Vue d’ensemble des points de terminaison

Method	Endpoint	Description
GET	/2/users/:id/muting	Obtenir la liste des comptes masqués
POST	/2/users/:id/muting	Masquer un compte
DELETE	/2/users/:source_user_id/muting/:target_user_id	Démasquer un compte

---

​

Champs et expansions

​

Réponse par défaut

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

​

Champs disponibles

user.fields

Champ	Description
created_at	Date de création du compte
description	Biographie de l’utilisateur
profile_image_url	URL de l’image de profil
public_metrics	Nombre d’abonnés et d’abonnements
verified	Statut de vérification

expansions

Expansion	Description
pinned_tweet_id	Publication épinglée de l’utilisateur

​

Exemple avec des champs

cURL

shellscript

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

---

​

Pagination

Pour les utilisateurs ayant de grandes listes de comptes masqués, les résultats sont paginés :

cURL

shellscript

# Première requête
curl "https://api.x.com/2/users/123/muting?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# Requête suivante avec un jeton de pagination
curl "https://api.x.com/2/users/123/muting?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Guide de pagination

En savoir plus sur la pagination

---

​

Différences de comportement

​

Masquer vs Bloquer

Fonctionnalité	Masquer	Bloquer
Voir leurs Publications	Non (masquées)	Non
Ils voient vos Publications	Oui	Non
Ils vous suivent	Oui (peuvent vous suivre)	Non (retiré)
Ils peuvent vous envoyer un DM	Oui	Non
Notification envoyée	Non	Non

Le masquage est privé — l’utilisateur masqué n’est pas notifié et ne peut pas savoir qu’il a été masqué.

---

​

Gestion des erreurs

Statut	Erreur	Solution
400	Requête non valide	Vérifiez le format de l’ID utilisateur
401	Non autorisé	Vérifiez le jeton d’accès
403	Accès interdit	Vérifiez les scopes et les autorisations
404	Introuvable	L’utilisateur n’existe pas
429	Trop de requêtes	Patientez puis réessayez

---

​

Prochaines étapes

Démarrage rapide

Effectuez votre première requête de mise en sourdine

Blocages

Bloquez des utilisateurs plutôt que de les mettre en sourdine

Référence de l’API

Documentation complète du point de terminaison

Exemples de code

Exemples de code prêts à l’emploi