İzleme

Bir hesabı izle

POST /v1/monitor/targets targets:write

screen_name veya user_id ile belirtilen bir hesabı izlemeye başlar. Hesabı zaten tanıyorsak hemen abone olursunuz; tanımıyorsak önce X'te çözümleriz ve 202 alırsınız. X'in son on dakika içinde izlenemeyeceğini bize bildirdiği bir hesap (mevcut değil, askıya alınmış ya da gönderileri korumalı) hemen 404 ile reddedilir. event_types olmadan anahtarınızın izin verdiği her olay türü iletilir; varsa yalnızca o türler. Zaten izlediğiniz bir hesap için event_types göndermek seçimi değiştirir; göndermemek seçimi korur. Bkz. Olay türlerini seçme.

İstek gövdesi

Gövde alanı	Tür	Anlamı
`screen_name`	string	`@` olmadan kullanıcı adı; 1–15 harf, rakam veya alt çizgi. Bunu ya da `user_id` gönderin
`user_id`	string	`screen_name` yerine hesabın sayısal X kimliği. Kimlik hiç değişmez; elinizdeyse bunu tercih edin
`event_types`	string[]	Bu hesap için yalnızca bu olay türleri iletilir; hepsi için göndermeyin ya da `[]` gönderin. `search.match` anahtar kelimelere aittir ve burada reddedilir

yanıt

201 abone olundu, 200 zaten abone, 202 çözümleme için kuyruğa alındı; üçü de ayrıntı uç noktasını gösteren bir Location başlığı taşır. Daha önce başarısız olmuş bir hesap için dönen 202, last_failure (reason, failed_at) taşır. 404 user_not_found, user_suspended veya user_protected: X son on dakika içinde bu hesabın izlenemeyeceğini bize bildirdi; details.failed_at ne zaman olduğunu söyler.

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

istek

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

yanıt · 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}"
}