监控
选择账号的事件类型
PATCH /v1/monitor/targets/{target} targets:write
修改一个已监控账号(或仍在解析中的账号)要送达哪些事件类型。这个选择对实时流、Webhook 和 GET /v1/events 同样生效;重新放宽后,新增的类型从那一刻起送达。已打开的连接会在下一次刷新时带上新设置。带上详情接口返回的 ETag 作为 If-Match,可避免覆盖别人同时做的修改。完整的可选类型和常见组合见选择事件类型。 {target} 指定账号:它的用户 id、当前用户名,或以前用过的用户名。
请求体
| 请求体字段 | 类型 | 含义 |
|---|---|---|
event_types * | string[] | null | 要送达的事件类型,取自 GET /v1/meta/event-types;null 或 [] 表示全部 |
响应
200 返回更新后的 Target(或待解析的形态);400 invalid_request 在 details.unknown 中列出未知类型;404 not_subscribed;If-Match 过期时返回 412。 逐字段说明: 监控目标.
状态: 200, 400, 404, 412
请求
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", "followers.verified.add"]}'
响应 · 200 / 400
{
"target": {
"id": "44196397",
"screen_name": "elonmusk",
"name": "Elon Musk",
"previous_screen_names": [],
"push_ready": true,
"last_push_at": "2026-09-16T08:12:03.417000+00:00",
"last_poll_at": "2026-09-16T08:12:10.002000+00:00",
"state": "subscribed",
"event_types": [
"tweet.create",
"followers.verified.add"
],
"event_types_all": false
}
}