Passer au contenu principal
Cette première version de la consultation des Messages privés inclut trois méthodes GET :
  • GET /2/dm_conversations/with/:participant_id/dm_events - Récupère les événements de Messages privés associés à une conversation en tête‑à‑tête. Le paramètre de chemin :participant_id correspond à l’ID utilisateur du compte en conversation avec l’utilisateur authentifié qui effectue cette requête.
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - Récupère les événements de Messages privés associés à un ID de conversation spécifique, tel qu’indiqué par le paramètre de chemin :dm_conversation_id.
  • GET /2/dm_events - Récupère les événements de Messages privés associés à un utilisateur, y compris les conversations en tête‑à‑tête et de groupe. Les événements des 30 derniers jours sont disponibles.
Notez que les id d’événement de Message privé sont communs entre v1.1 et v2 (ainsi que dans la X App), de sorte que la méthode v1.1 pour répertorier un seul événement peut être utilisée avec ces nouveaux endpoints v2. Notez également que les Account Activity API Enterprise et Premium prennent en charge les messages v2 en tête‑à‑tête, mais ne prennent pas encore en charge les conversations de groupe. Avec cette version, trois types d’événements sont pris en charge, et ces endpoints acceptent des paramètres de query pour les filtrer :
  • MessageCreate - Un message a été créé.
  • ParticipantsJoin - Un nouveau participant a rejoint une conversation.
  • ParticipantsLeave - Un participant a quitté une conversation.
Une limite de taux par utilisateur de 300 requêtes par 15 minutes s’applique aux méthodes GET. Cette limite de taux est partagée entre ces endpoints GET. Comme vous effectuez des requêtes pour le compte d’un utilisateur avec les endpoints v2 de Messages privés, vous devez vous authentifier soit avec OAuth 1.0a User Context, soit avec OAuth 2.0 Authorization Code with PKCE, en utilisant des Access Tokens associés aux utilisateurs ayant autorisé votre X App. Pour générer ces Access Tokens avec OAuth 1.0a, vous pouvez utiliser le flux OAuth à 3 étapes. Pour générer des Access Tokens utilisateur avec OAuth 2.0, vous pouvez utiliser le flux d’autorisation Authorization Code with PKCE. Configuration du compte Pour accéder à ces endpoints, vous aurez besoin de : En savoir plus sur l’accès aux endpoints X API v2 dans notre guide de démarrage.
⌘I