JobStartStopストリームのアクティブ化/非アクティブ化のスケジューリングエンドポイントを使用すると、アクティベーションをスケジュールできます。既存のライブ SEPジョブの非アクティブ化。指定された時間に、当社のシステムは、ユーザーに代わってジョブをアクティブ化および非アクティブ化するために必要なAPI呼び出しを行います。要件
スケジューラーを作成する
2021-04-02T 14:00:00 + 00:00 に始まる2時間のイベントをスケジュールするとしましょう。
タイムスタンプは、秒単位のUNIXタイムスタンプとしてUTC形式である必要があります。https://www.unixtimestamp.com/で変換できます。
スケジューラを実装するには、POST次のリクエストを実行します。
https://api.bcovlive.io/v1/scheduler/jobstartstopヘッダー
Content-Type: application/json
X-API-KEY: {your API Key}リクエスト本文
{
"job_id": "your Job ID",
"activation": {
"time_utc": 1617386100
},
"deactivation": {
"time_utc": 1617393600
},
"description": "My Wednesday broadcast"
}レスポンスの例
{
"account_id": "1752604059001",
"activation": {
"state": "pending",
"time_utc": 1617386100
},
"deactivation": {
"state": "pending",
"time_utc": 1617393600
},
"description": "My Wednesday broadcast",
"job_id": "15981d93877e490185e6ebc9af2c79a3",
"type": "jobstartstop",
"workflow_id": "d44cf29f4f184757ac0995beb8a0097e"
}スケジューラーを更新する
あなたは更新することができますアクティベーションおよび/または非アクティブ化ジョブが保留中州 （「状態」：「保留中」）。これを行うには、 PUT リクエストを次の宛先に送信します。
https://api.bcovlive.io/v1/scheduler/jobstartstop/{workflow_id}ヘッダーは、上記の POSTリクエストと同じです。
リクエスト本文
リクエスト本文オブジェクトには、アクティベーションおよび/または非アクティブ化田畑。
たとえば、予定より30分早くイベントを停止するには：
リクエスト本文
{
"deactivation": {
"time_utc": 1617391800
}
}レスポンスの例
{
"account_id": "1752604059001",
"activation": {
"state": "pending",
"time_utc": 1617386100
},
"deactivation": {
"state": "pending",
"time_utc": 1617391800
},
"description": "My Wednesday broadcast",
"job_id": "15981d93877e490185e6ebc9af2c79a3",
"type": "jobstartstop",
"workflow_id": "d44cf29f4f184757ac0995beb8a0097e"
}スケジューラをキャンセルする
DELETEリクエストを使用して、アクティベーションと非アクティブ化をキャンセルできます。
https://api.bcovlive.io/v1/scheduler/jobstartstop/{workflow_id}アクティベーション後にこれを行うと、非アクティブ化を取り消すこともできます。
ヘッダー
必要なヘッダーは次のとおりです。
X-API-KEY: your API Keyリクエスト本文
このリクエストにはリクエスト本文がありません。
レスポンスの例
{
"account_id": "1752604059001",
"activation": {
"state": "cancelled",
"time_utc": 1617386100
},
"deactivation": {
"state": "cancelled",
"time_utc": 1617391800
},
"description": "My Wednesday broadcast",
"job_id": "15981d93877e490185e6ebc9af2c79a3",
"type": "jobstartstop",
"workflow_id": "d44cf29f4f184757ac0995beb8a0097e"
}通知
オプションで、ワークフローの作成時に通知を構成できます。POSTするサービスの URLを提供する必要があります。スケジューラーがアクティブ化および非アクティブ化の呼び出しを行うと、通知が送信されます。アクティベーションまたは非アクティブ化の n秒前に通知を受信するようにを設定することもできます。詳細については、ライブスケジューラ通知を参照してください。
リクエスト本文の例
{
"job_id": "your Job ID",
"activation": {
"time_utc": 1612274100,
"notification": 600
},
"deactivation": {
"time_utc": 1612281600,
"notification": 600
},
"description": "My Tuesday broadcast",
"notification_url": "http://example.com/live/jobstartstop/callbacks"
}