메인 콘텐츠로 건너뛰기Direct Messages 조회의 초기 릴리스에는 다음 세 가지 GET 메서드가 포함됩니다:
- GET /2/dm_conversations/with/:participant_id/dm_events - 일대일 대화와 연관된 Direct Message 이벤트를 검색합니다. :participant_id 경로 매개변수는 이 요청을 수행하는 인증된 사용자와 대화 중인 계정의 사용자 ID입니다.
- GET /2/dm_conversations/:dm_conversation_id/dm_events - :dm_conversation_id 경로 매개변수로 지정된 특정 대화 ID와 연관된 Direct Message 이벤트를 검색합니다.
- GET /2/dm_events - 사용자와 연관된 Direct Message 이벤트를 검색하며, 일대일 및 그룹 대화를 모두 포함합니다. 최대 30일 전의 이벤트까지 제공됩니다.
Direct Message 이벤트 ID는 v1.1과 v2(및 X App) 전반에서 공통이므로, 단일 이벤트를 목록화하는 v1.1 메서드를 새로운 v2 엔드포인트와 함께 사용할 수 있습니다. 또한 Enterprise 및 Premium Account Activity API는 v2 일대일 메시지를 지원하지만 아직 그룹 대화는 지원하지 않습니다.
이번 릴리스에서는 세 가지 이벤트 유형이 지원되며, 이 엔드포인트들은 해당 이벤트를 필터링하기 위한 쿼리 매개변수를 지원합니다:
- MessageCreate - 메시지가 생성되었습니다.
- ParticipantsJoin - 새로운 참여자가 대화에 합류했습니다.
- ParticipantsLeave - 참여자가 대화에서 나갔습니다.
GET 메서드에는 15분당 300건의 사용자 레이트 리밋이 적용됩니다. 이 레이트 리밋은 해당 GET 엔드포인트 간에 공유됩니다.
Direct Message v2 엔드포인트로 사용자를 대신해 요청을 수행하므로, OAuth 1.0a User Context 또는 OAuth 2.0 Authorization Code with PKCE로 인증해야 하며, 귀하의 X App을 승인한 사용자와 연관된 액세스 토큰을 사용해야 합니다. OAuth 1.0a로 이러한 액세스 토큰을 생성하려면 3-legged OAuth 플로우를 사용할 수 있습니다. OAuth 2.0으로 사용자 액세스 토큰을 생성하려면 Authorization Code with PKCE grant flow를 사용할 수 있습니다.
계정 설정
이 엔드포인트에 액세스하려면 다음이 필요합니다:
X API v2 엔드포인트에 대한 액세스 권한 얻기에 대해 시작하기 가이드에서 자세히 알아보세요.
