Pemantauan
Operasi pemantauan batch
POST /v1/monitor/targets:batch targets:write
Hingga 100 operasi tambah atau hapus dalam satu panggilan, masing-masing dengan semantik yang sama seperti endpoint tunggal.
Isi permintaan
| Bidang body | Tipe | Arti |
|---|---|---|
items * | BatchItem[] (1–100) | Operasinya, diterapkan berurutan |
items[].op * | add | remove | Apa yang harus dilakukan |
items[].screen_name | string | Akun yang mana, lewat handle; atau kirim user_id |
items[].user_id | string | Akun yang mana, lewat id pengguna, sebagai ganti screen_name |
items[].event_types | string[] (add only) | Untuk add: sama dengan event_types pada panggilan tunggal |
respons
Selalu 200; setiap hasil membawa status dan body yang akan dihasilkan panggilan item tunggal, ditambah total di meta. Bidang demi bidang: Hasil batch.
Status: 200, 400
permintaan
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"}]}'
respons · 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
}
}