监控

批量监控操作

POST /v1/monitor/targets:batch targets:write

一次调用最多 100 个添加或移除操作，每个操作的语义与单项端点相同。

请求体

请求体字段类型含义
items *BatchItem[] (1–100)操作列表，按顺序执行
items[].op *add | remove要做什么
items[].screen_namestring哪个账号（按用户名）；也可改传 user_id
items[].user_idstring哪个账号（按用户 id），代替 screen_name
items[].event_typesstring[] (add only)仅用于 add：与单条调用中的 event_types 相同

响应

始终 200；每个结果携带单项调用本会产生的状态和响应体，meta 中有汇总。 逐字段说明： 批量结果.

状态: 200, 400

请求
curl -X POST https://api.xsignalfeed.com/v1/monitor/targets:batch \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"items": [{"op": "add", "screen_name": "Reuters"}, {"op": "add", "screen_name": "not a handle"}, {"op": "remove", "user_id": "783214"}]}'
响应 · 200 / 400
{
  "results": [
    {
      "index": 0,
      "status": 201,
      "data": {
        "state": "subscribed",
        "screen_name": "Reuters",
        "…": "…"
      }
    },
    {
      "index": 1,
      "status": 400,
      "error": {
        "code": "invalid_request",
        "message": "screen_name must be 1-15 letters, digits or underscores",
        "details": {
          "field": "screen_name"
        }
      }
    },
    {
      "index": 2,
      "status": 200,
      "data": {
        "status": "not_subscribed",
        "id": "783214",
        "screen_name": null
      }
    }
  ],
  "meta": {
    "count": 3,
    "succeeded": 2,
    "failed": 1
  }
}