Skip to main content

​
Comparaison des endpoints de recherche d’événements de messages privés v1.1 et v2

Les versions v1.1 et v2 des endpoints Direct Messages fournissent toutes deux des méthodes pour rechercher des événements de messages privés. Ce guide a pour but d’expliquer les différences et de fournir des informations pour migrer vers v2.  Une différence majeure entre les deux versions est que v1.1 ne prend en charge que les conversations en tête‑à‑tête, alors que v2 introduit la prise en charge des conversations de groupe. Il en résulte que v1.1 ne prend en charge que les événements de type « message created », tandis que v2 prend également en charge les événements associés aux participants rejoignant et quittant les conversations. En fait, une mise à jour fondamentale de v2 consiste à établir dm_conversations comme objet d’API principal.    Avec v1.1, il existe deux endpoints pour récupérer des messages privés (encore une fois, les nouveaux messages sont le seul type d’événement pris en charge avec v1.1) :
  • GET direct_messages/events/show - Récupère un seul événement par ID. 
  • GET direct_messages/events/list - Récupère jusqu’à 30 jours de messages privés en tête‑à‑tête envoyés et reçus par l’utilisateur authentifié. Notez que cette méthode ne permet pas de récupérer les messages des conversations de groupe. 
Avec cette version v2, il existe trois méthodes GET pour récupérer les événements de conversation de messages privés : 
  • 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 qui est en conversation avec l’utilisateur authentifié effectuant 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. Cette méthode prend en charge les conversations en tête‑à‑tête et les conversations de groupe. 
  • 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 remontant jusqu’à 30 jours sont disponibles.  
Un détail important est que les identifiants de conversation et d’événement sont partagés entre les versions v1.1 et v2 de la plateforme X. Cela signifie que les deux versions peuvent être utilisées ensemble. Par exemple, les endpoints Direct Messages v1.1 fournissent des méthodes pour renvoyer un seul événement et pour supprimer des événements, des méthodes qui ne sont pas encore disponibles avec v2. Étant donné que les identifiants sont communs à v1.1 et v2, vous pouvez effectuer des requêtes v1.1 à partir d’identifiants fournis par v2, ou en vous référant aux identifiants de conversation affichés dans les URL de conversation sur l’application X. Le tableau suivant compare les aspects fondamentaux des endpoints de recherche d’événements de messages privés v1.1 et v2. Les caractéristiques de X API v2 présentées ici sont communes à tous les endpoints de recherche de messages privés. Les tableaux suivants comparent les méthodes GET v2 avec celles de la version v1.1. Notez que ces fonctionnalités v2 étendent les capacités disponibles en prenant en charge les conversations de groupe.  **Récupérer tous les messages dans une conversation en tête‑à‑tête spécifique **
Chemin : GET /2/dm_conversations/with/:participant_id/dm_events **Récupérer tous les messages par ID de conversation ** Chemin : GET /2/dm_conversations/:dm_conversation_id/dm_events Récupérer tous les événements pour l’ensemble des conversations d’un utilisateur authentifié, à la fois individuelles et de groupe Chemin : GET /2/dm_events