アカウントが所有する監視タスクを返します。追跡対象の確認や、他のTwitch監視エンドポイントで使う監視IDの取得に利用します。
GET
/api/v1/twitch/monitor/listクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。
リクエストパラメータ
必須パラメータ
このエンドポイントに必須パラメータはありません。
任意パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
page | query | integer | Page number |
page_size | query | integer | Page size |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
お試し実行
https://openapi.scdata.cc/api/v1/twitch/monitor/list
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
pagepage_sizecURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/twitch/monitor/list" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"monitor_id": "string","monitor_url": "string","user_login": "string","user_id": 0,"monitor_start_time": "2019-08-24T14:15:22.123Z","monitor_end_time": "2019-08-24T14:15:22.123Z"}],"total": 0,"page": 0,"page_size": 0,"total_pages": 0}}
ユースケース
- タスクの整理 — 有効な監視を確認し、不要なものを停止します。
- ポートフォリオ概要 — 監視中の配信者全員を1つの社内ページに表示します。