Pemantauan

Pantau sebuah akun

POST /v1/monitor/targets targets:write

Mulai memantau sebuah akun, ditentukan dengan screen_name atau user_id. Jika kami sudah mengenalnya, Anda langsung berlangganan; jika belum, kami menyelesaikannya dulu di X dan Anda mendapat 202. Akun yang menurut X dalam sepuluh menit terakhir tidak dapat dipantau (tidak ada, ditangguhkan, atau unggahannya terkunci) langsung ditolak dengan 404. Tanpa event_types, setiap tipe peristiwa yang diizinkan kunci Anda dikirim; dengan itu, hanya tipe tersebut. Mengirim event_types untuk akun yang sudah Anda pantau mengganti pilihannya; tidak mengirimnya mempertahankannya. Lihat Memilih tipe peristiwa.

Isi permintaan

Bidang body	Tipe	Arti
`screen_name`	string	Handle tanpa `@`; 1–15 huruf, angka atau garis bawah. Kirim ini atau `user_id`
`user_id`	string	Id numerik X milik akun, sebagai ganti `screen_name`. Id tidak pernah berubah, jadi utamakan bila Anda memilikinya
`event_types`	string[]	Hanya tipe peristiwa ini yang dikirim untuk akun ini; kosongkan atau kirim `[]` untuk semua. `search.match` milik kata kunci dan ditolak di sini

respons

201 berlangganan, 200 sudah berlangganan, 202 diantrekan untuk pencocokan; ketiganya membawa header Location yang menunjuk ke endpoint detail. 202 untuk akun yang sebelumnya gagal membawa last_failure (reason, failed_at). 404 user_not_found, user_suspended, atau user_protected: X memberi tahu kami dalam sepuluh menit terakhir bahwa akun ini tidak dapat dipantau; details.failed_at menyebutkan kapan.

Status: 201, 200, 202, 400, 402, 403

permintaan

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

respons · 201 / 200

{
  "status": "subscribed",
  "state": "subscribed",
  "id": "44196397",
  "screen_name": "elonmusk",
  "name": "Elon Musk",
  "event_types": [
    "followers.verified.add"
  ],
  "event_types_all": false
}
{
  "status": "queued",
  "state": "queued",
  "screen_name": "newaccount",
  "user_id": null,
  "event_types": [],
  "event_types_all": true,
  "note": "target will be resolved and placed shortly; poll GET /v1/monitor/targets/{screen_name}"
}