메인 콘텐츠로 건너뛰기
Account Activity API는 실시간 계정 활동 이벤트를 웹훅으로 전달합니다. 사용자 계정을 구독하여 사용자가 게시물을 올리거나 DM을 받거나 팔로우되는 등의 활동이 발생할 때 알림을 받을 수 있습니다.

​
개요

Webhook 전달

서버로 전달되는 이벤트

실시간

실시간 이벤트 알림

종합적

포스트, DM, 팔로우, 좋아요 등

구독 기반

사용자 계정 구독

​
동작 방식

  1. 웹훅 등록 — 웹훅 URL을 등록합니다.
  2. 사용자 구독 설정 — 사용자 구독을 설정합니다.
  3. 이벤트 수신 — POST 요청으로 활동 이벤트를 수신합니다.
  4. 이벤트 처리 — 애플리케이션에서 이벤트를 처리합니다.

​
이벤트 유형

카테고리이벤트
포스트생성, 삭제, 좋아요, 좋아요 취소
다이렉트 메시지수신, 발신, 입력 상태 표시
팔로우팔로우, 언팔로우
차단차단, 차단 해제
뮤트뮤트, 뮤트 해제

​
Webhook 보안

모든 webhook 요청에는 다음이 포함됩니다:
  • CRC validation — webhook의 진위 여부를 검증합니다
  • Signature header — x-twitter-webhooks-signature
  • HTTPS required — 모든 webhook URL은 HTTPS를 반드시 사용해야 합니다

​
예제: 웹훅 등록

curl -X POST "https://api.x.com/1.1/account_activity/all/env-name/webhooks.json?\
url=https%3A%2F%2Fyour-server.com%2Fwebhook" \
  -H "Authorization: OAuth oauth_consumer_key=..."

​
시작하기

사전 준비 사항

Activity stream

웹훅의 스트리밍 방식 대안

마이그레이션 가이드

v1.1에서 마이그레이션

API 참조 문서

전체 엔드포인트에 대한 문서