Guide d’intégration

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

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Récupérer les utilisateurs mis en sourdine avec des champs supplémentaires
for page in client.users.get_muting(
    user_id="123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Vérifié : {user.verified}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

const paginator = client.users.getMuting("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Vérifié : ${user.verified}`);
  });
}

Pagination

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

cURL

# 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"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Le SDK gère automatiquement la pagination
all_muted = []

for page in client.users.get_muting(user_id="123", max_results=100):
    if page.data:
        all_muted.extend(page.data)

print(f"{len(all_muted)} comptes masqués")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

async function getAllMutedUsers(userId) {
  const allMuted = [];

  // Le SDK gère automatiquement la pagination
  const paginator = client.users.getMuting(userId, { maxResults: 100 });

  for await (const page of paginator) {
    if (page.data) {
      allMuted.push(...page.data);
    }
  }

  return allMuted;
}

// Utilisation
const muted = await getAllMutedUsers("123");
console.log(`${muted.length} comptes masqués`);

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

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Guide d’intégration

Authentification

Scopes requis (OAuth 2.0)

Vue d’ensemble des points de terminaison

Champs et expansions

Réponse par défaut

Champs disponibles

Exemple avec des champs

Guide de pagination

Différences de comportement

Masquer vs Bloquer

Gestion des erreurs

Prochaines étapes

Démarrage rapide

Blocages

Référence de l’API

Exemples de code

​Authentification

​Scopes requis (OAuth 2.0)

​Vue d’ensemble des points de terminaison

​Champs et expansions

​Réponse par défaut

​Champs disponibles

​Exemple avec des champs

​Pagination

Guide de pagination

​Différences de comportement

​Masquer vs Bloquer

​Gestion des erreurs

​Prochaines étapes

Démarrage rapide

Blocages

Référence de l’API

Exemples de code

Authentification

Scopes requis (OAuth 2.0)

Vue d’ensemble des points de terminaison

Champs et expansions

Réponse par défaut

Champs disponibles

Exemple avec des champs

Pagination

Différences de comportement

Masquer vs Bloquer

Gestion des erreurs

Prochaines étapes