이벤트 타입 선택

기본적으로 모니터링하는 각 계정의 모든 이벤트 타입이 전달됩니다. 이를 계정별로 좁힐 수 있습니다. 한 계정에서는 새 인증 팔로워만, 다른 계정에서는 올리는 모든 것을 받는 식입니다. 선택은 구독에 속하므로 계정마다 따로 정해집니다.

선택할 수 있는 것

아래 이벤트 타입은 계정마다 하나씩 켜거나 끌 수 있습니다. 키워드 일치(search.match)는 이 목록에 없습니다. 이는 계정이 아니라 키워드에서 옵니다.

타입카테고리의미
tweet.create게시물계정이 새 게시물을 올렸습니다
tweet.reply게시물누군가에게 답글을 달았습니다. reply_to에 답글 대상 게시물이 텍스트와 미디어와 함께 담깁니다
tweet.retweet게시물누군가의 게시물을 리포스트했습니다. retweet_of에 원본 게시물 전체가 담깁니다
tweet.quote게시물누군가의 게시물을 인용했습니다. quoted에 인용된 게시물 전체가 담깁니다
tweet.edit게시물게시물을 수정했습니다. 이벤트는 새 버전을 담고, edit_of는 이 버전이 대체한 버전입니다
tweet.delete게시물계정이 게시했던 게시물이 사라졌습니다
profile.name프로필표시 이름 변경
profile.screen_name프로필핸들 변경
profile.bio프로필소개 변경
profile.location프로필위치 변경
profile.url프로필프로필 링크 변경
profile.avatar프로필아바타 변경. old와 new는 이미지 URL입니다
profile.banner프로필배너 변경. old와 new는 이미지 URL입니다
profile.pinned프로필고정 게시물 변경. tweet과 old_tweet에 게시물 자체가 담깁니다
profile.verified프로필인증 배지가 생기거나 사라졌습니다
follow.add팔로우 그래프계정이 누군가를 팔로우하기 시작했습니다. user는 그 계정의 전체 프로필입니다
follow.remove팔로우 그래프계정이 누군가를 언팔로우했습니다
followers.verified.add팔로우 그래프인증 계정이 팔로우하기 시작했습니다. user에 소개, 각종 수치, 위치, 가입일이 담깁니다
account.status계정계정이 비공개, 정지, 볼 수 없는 상태가 되었거나 정상으로 돌아왔습니다

자주 쓰는 선택

오른쪽 열의 값을 event_types로 보내세요. 타입은 자유롭게 조합되며 필요한 만큼 나열하면 됩니다.

원하는 것event_types
그 계정의 새 인증 팔로워만["followers.verified.add"]
원본 게시물만["tweet.create"]
답글만["tweet.reply"]
올리는 모든 것: 게시물, 답글, 리포스트, 인용, 수정["tweet.create", … 5 개 타입]
게시물과 게시물 삭제["tweet.create", "tweet.delete"]
프로필 변경만(프로필 타입 9개 전부)["profile.name", … 9 개 타입]
누구를 팔로우·언팔로우했는지만["follow.add", "follow.remove"]
전부(기본값)null

설정 방법

모니터링을 시작할 때 고르거나, 이후 언제든 바꿀 수 있습니다. 두 호출 모두 targets:write 스코프가 필요합니다.

선택을 지정해 모니터링 시작
curl -X POST https://api.xsignalfeed.com/v1/monitor/targets \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"screen_name": "elonmusk", "event_types": ["followers.verified.add"]}'
나중에 선택 변경
curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": ["tweet.create", "tweet.reply"]}'
모든 타입으로 되돌리기
curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": null}'

계정의 현재 선택은 event_types 필드에 있으며, 아무것도 제외하지 않으면 event_types_all이 true입니다.

GET /v1/monitor/targets/elonmusk
{
  "target": {
    "id": "44196397",
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "state": "subscribed",
    "…": "…",
    "event_types": [
      "tweet.create",
      "tweet.reply"
    ],
    "event_types_all": false
  }
}

규칙

선택할 수 없는 것