Skip to main content

​
v1.1 및 v2 다이렉트 메시지 이벤트 조회 엔드포인트 비교

v1.1과 v2 버전의 다이렉트 메시지 엔드포인트는 모두 다이렉트 메시지 이벤트를 조회하는 메서드를 제공합니다. 이 가이드는 두 버전 간의 차이를 이해하고 v2로 마이그레이션하는 데 필요한 정보를 제공하기 위한 것입니다.  두 버전 간의 주요 차이점은 v1.1은 1:1 대화만 지원하는 반면, v2에서는 그룹 대화 지원이 도입되었다는 점입니다. 이와 관련해 나타나는 차이점 중 하나는 v1.1은 “message created” 이벤트만 지원하는 반면, v2는 참가자가 대화에 참여하거나 떠나는 것과 관련된 이벤트도 지원한다는 것입니다. 특히 v2의 근본적인 업데이트 중 하나는 dm_conversations를 핵심 API 객체로 확립한 것입니다.    v1.1에서는 다이렉트 메시지를 가져오기 위한 엔드포인트가 두 개 있습니다(다시 말해, v1.1에서 지원되는 이벤트 타입은 새 메시지뿐입니다).
  • GET direct_messages/events/show - ID로 단일 이벤트를 가져옵니다. 
  • GET direct_messages/events/list - 인증된 사용자가 주고받은 1:1 다이렉트 메시지를 최대 30일 치까지 가져옵니다. 이 메서드는 그룹 대화의 메시지를 가져올 수 없다는 점에 유의하세요. 
v2에서는 다이렉트 메시지 대화 이벤트를 가져오기 위한 GET 메서드가 세 가지 있습니다. 
  • GET /2/dm_conversations/with/:participant_id/dm_events - 1:1 대화와 관련된 다이렉트 메시지 이벤트를 가져옵니다. :participant_id 경로 파라미터는 이 요청을 보내는 인증된 사용자와 대화를 나누고 있는 계정의 사용자 ID입니다. 
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - :dm_conversation_id 경로 파라미터로 지정된 특정 대화 ID와 관련된 다이렉트 메시지 이벤트를 가져옵니다. 이 메서드는 1:1 및 그룹 대화를 모두 지원합니다. 
  • GET /2/dm_events - 사용자와 관련된 다이렉트 메시지 이벤트를 가져오며, 여기에는 1:1 및 그룹 대화가 모두 포함됩니다. 최대 30일 전까지의 이벤트를 조회할 수 있습니다.  
중요한 점은 대화 및 이벤트 ID가 X 플랫폼의 v1.1과 v2 버전 간에 공유된다는 것입니다. 이는 두 버전을 함께 사용할 수 있음을 의미합니다. 예를 들어, 다이렉트 메시지 v1.1 엔드포인트는 단일 이벤트를 반환하고 이벤트를 삭제하는 메서드를 제공하는데, 이는 아직 v2에서는 제공되지 않습니다. ID가 v1.1과 v2 간에 공통이므로, v2가 제공하는 ID를 기반으로 v1.1 요청을 하거나 X 애플리케이션의 대화 URL에 표시되는 대화 ID를 참조해 v1.1 요청을 보낼 수 있습니다. 다음 표는 v1.1 및 v2 다이렉트 메시지 이벤트 조회 엔드포인트의 기본적인 측면을 비교합니다. 여기에서 설명하는 X API v2 특성은 모든 다이렉트 메시지 조회 엔드포인트에 공통적으로 적용됩니다. 다음 표들은 v2 GET 메서드를 v1.1 버전과 비교합니다. 이 v2 제공 기능이 그룹 대화를 지원함으로써 사용 가능한 기능을 확장한다는 점에 유의하세요.  **특정 1:1 대화의 모든 메시지 가져오기 **
Path: GET /2/dm_conversations/with/:participant_id/dm_events 대화 ID로 모든 메시지 가져오기 경로: GET /2/dm_conversations/:dm_conversation_id/dm_events 인증된 사용자의 모든 대화(일대일 및 그룹 대화 모두)에 대한 모든 이벤트 가져오기 경로: GET /2/dm_events