모니터링

모니터링 배치 작업

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

한 번의 호출로 최대 100개의 추가 또는 제거 작업. 각 작업은 단일 엔드포인트와 같은 의미입니다.

요청 본문

본문 필드	타입	의미
`items` *	BatchItem[] (1–100)	작업 목록. 순서대로 적용
`items[].op` *	add \| remove	수행할 작업
`items[].screen_name`	string	대상 계정(핸들). `user_id`로도 지정할 수 있습니다
`items[].user_id`	string	대상 계정(사용자 id). `screen_name` 대신 사용합니다
`items[].event_types`	string[] (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
  }
}