v1.1과 v2 Direct Message 이벤트 조회 endpoint 비교
Direct Message endpoint의 v1.1과 v2 버전 모두 Direct Message 이벤트를 조회하는 방법을 제공합니다. 이 가이드는 두 버전의 차이점을 이해하고 v2로 마이그레이션하는 데 필요한 정보를 제공하기 위한 것입니다. 두 버전의 주요 차이점은 v1.1이 1:1 대화만 지원하는 반면, v2에서는 그룹 대화 지원이 추가되었다는 점입니다. 이로 인해 v1.1은 “메시지 생성” 이벤트만 지원하지만, v2에서는 대화 참여 및 나가기 관련 이벤트도 지원합니다. 실제로 v2의 근본적인 업데이트는 dm_conversations를 핵심 API 객체로 정립한 것입니다. v1.1에는 Direct Message를 조회하는 두 개의 endpoint가 있습니다(v1.1에서 지원되는 유일한 이벤트 유형은 새 메시지입니다):- GET direct_messages/events/show - ID로 단일 이벤트를 조회합니다.
- GET direct_messages/events/list - 인증된 사용자가 주고받은 1:1 Direct Message를 최대 30일까지 조회합니다. 이 메서드는 그룹 대화의 메시지를 조회할 수 없습니다.
- GET /2/dm_conversations/with/:participant_id/dm_events - 1:1 대화와 관련된 Direct Message 이벤트를 조회합니다. :participant_id 경로 파라미터는 이 요청을 하는 인증된 사용자와 대화 중인 계정의 User ID입니다.
- GET /2/dm_conversations/:dm_conversation_id/dm_events - :dm_conversation_id 경로 파라미터로 지정된 특정 대화 ID와 관련된 Direct Message 이벤트를 조회합니다. 이 메서드는 1:1 대화와 그룹 대화 모두를 지원합니다.
- GET /2/dm_events - 사용자와 관련된 Direct Message 이벤트를 조회합니다. 1:1 대화와 그룹 대화가 모두 포함됩니다. 최대 30일 전까지의 이벤트를 사용할 수 있습니다.
다음 표는 v2 GET 메서드와 v1.1을 비교합니다. 이러한 v2 제공 기능은 그룹 대화를 지원함으로써 사용 가능한 기능을 확장합니다.
특정 1:1 대화의 모든 메시지 가져오기
Path: GET /2/dm_conversations/with/:participant_id/dm_events
대화 ID로 모든 메시지 가져오기
Path: GET /2/dm_conversations/:dm_conversation_id/dm_events
인증된 사용자의 1:1 대화와 그룹 대화 모두를 아우르는 모든 이벤트 가져오기
Path: GET /2/dm_events