Memilih tipe peristiwa

Secara bawaan Anda menerima setiap tipe peristiwa dari setiap akun yang dipantau. Anda bisa mempersempitnya per akun: satu akun hanya mengirim pengikut terverifikasi barunya, sementara akun lain mengirim semua yang diunggahnya. Pilihan ini milik langganan, jadi dibuat terpisah untuk setiap akun.

Yang bisa Anda pilih

Setiap tipe peristiwa di bawah bisa dinyalakan atau dimatikan satu per satu, untuk setiap akun. Kecocokan kata kunci (search.match) tidak ada di daftar ini: itu berasal dari kata kunci, bukan dari akun.

Tipe	Kategori	Arti
`tweet.create`	Unggahan	Akun mengunggah sesuatu yang baru
`tweet.reply`	Unggahan	Akun membalas seseorang; `reply_to` membawa unggahan yang dibalas, beserta teks dan medianya
`tweet.retweet`	Unggahan	Akun mengunggah ulang unggahan seseorang; `retweet_of` membawa unggahan aslinya secara lengkap
`tweet.quote`	Unggahan	Akun mengutip seseorang; `quoted` membawa unggahan yang dikutip secara lengkap
`tweet.edit`	Unggahan	Akun mengedit sebuah unggahan; peristiwa membawa versi baru, dan `edit_of` versi yang digantikannya
`tweet.delete`	Unggahan	Sebuah unggahan yang pernah dipublikasikan akun telah hilang
`profile.name`	Profil	Nama tampilan berubah
`profile.screen_name`	Profil	Handle berubah
`profile.bio`	Profil	Bio berubah
`profile.location`	Profil	Lokasi berubah
`profile.url`	Profil	Tautan profil berubah
`profile.avatar`	Profil	Avatar berubah; `old` dan `new` adalah URL gambar
`profile.banner`	Profil	Banner berubah; `old` dan `new` adalah URL gambar
`profile.pinned`	Profil	Unggahan tersemat berubah; `tweet` dan `old_tweet` membawa unggahannya sendiri
`profile.verified`	Profil	Lencana verifikasi muncul atau menghilang
`follow.add`	Graf pengikutan	Akun mulai mengikuti seseorang; `user` adalah profil lengkap akun tersebut
`follow.remove`	Graf pengikutan	Akun berhenti mengikuti seseorang
`followers.verified.add`	Graf pengikutan	Sebuah akun terverifikasi mulai mengikutinya; `user` membawa bio, jumlah, lokasi, tanggal bergabung
`account.status`	Akun	Akun menjadi terkunci, ditangguhkan atau tidak tersedia, atau aktif kembali

Pilihan umum

Kirim nilai di kolom kanan sebagai event_types. Tipe bisa digabung bebas; cantumkan sebanyak yang Anda perlukan.

Anda ingin	`event_types`
Hanya pengikut terverifikasi baru akun itu	`["followers.verified.add"]`
Hanya unggahan aslinya	`["tweet.create"]`
Hanya balasannya	`["tweet.reply"]`
Semua yang diterbitkannya: unggahan, balasan, repost, kutipan, dan suntingan	`["tweet.create", … 5 tipe]`
Unggahannya, dan saat ia menghapus salah satunya	`["tweet.create", "tweet.delete"]`
Hanya perubahan profil (kesembilan tipe profil)	`["profile.name", … 9 tipe]`
Hanya siapa yang ia ikuti dan berhenti ikuti	`["follow.add", "follow.remove"]`
Semuanya (bawaan)	`null`

Cara mengaturnya

Pilih saat mulai memantau akun, atau ubah kapan saja setelahnya. Kedua panggilan memerlukan scope targets:write.

Mulai memantau dengan pilihan

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"]}'

Ubah pilihan nanti

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"]}'

Kembali ke semua tipe

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}'

Pilihan akun saat ini ada di kolom event_types; event_types_all bernilai true jika tidak ada yang disaring.

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
  }
}

Aturan

Tidak mengirim event_types saat mulai memantau akun berarti semua tipe.
Mengirim event_types mengganti seluruh pilihan; tidak menambahkannya. Mengulang panggilan pemantauan tanpa event_types mempertahankan pilihan saat ini.
null atau [] berarti semua tipe. Memilih semua tipe dalam daftar disimpan dengan cara yang sama.
Pilihan berlaku sama untuk stream, webhook, dan GET /v1/events. Koneksi yang terbuka mengambil perubahan pada penyegaran berikutnya, tidak seketika.
update yang mengubah tipe unggahan (membawa kind_was) sampai kepada Anda bila salah satu dari kedua tipe ada dalam pilihan Anda. Jika Anda memilih tweet.create tetapi tidak tweet.quote, Anda tetap menerima update yang menunjukkan unggahan itu ternyata kutipan, sehingga bisa membuangnya; jika Anda memilih tweet.quote tetapi tidak tweet.create, kutipan seperti itu pertama kali sampai sebagai update tersebut.
Perluas pilihan dan tipe yang ditambahkan sampai sejak saat itu. Peristiwa bertipe itu dari sebelum perubahan tidak dijamin tersedia melalui GET /v1/events.
Sebuah kunci juga bisa memiliki daftar untuk seluruh kunci, yang kami atur atas permintaan Anda (event_types di GET /v1/account). Peristiwa hanya sampai jika kedua daftar mengizinkannya.
Tipe yang tidak dikenal ditolak dengan 400 invalid_request; details.unknown menyebutnya dan details.allowed mencantumkan yang bisa dipakai. GET /v1/meta/event-types memberi daftar lengkap.
Kata kunci dipilih per kata kunci, bukan di sini: pantau atau berhenti memantau kata kunci untuk mulai atau berhenti menerima peristiwa search.match-nya.

Yang tidak bisa dipilih

Pengikut baru yang tidak terverifikasi tidak disediakan sebagai peristiwa, jadi tidak bisa dipilih. Hanya pengikut terverifikasi baru yang tersedia (followers.verified.add).
Pilihan hanya berdasarkan tipe peristiwa, bukan isi. Syarat seperti "pengikut terverifikasi dengan lebih dari 10.000 pengikut", "hanya unggahan bergambar", atau "hanya bahasa Inggris" diterapkan di sisi Anda, memakai kolom dalam payload (misalnya user.followers, media, lang).