實時調度程序通知

使用調度程序創建工作流時，您可以選擇配置通知。

簡介

完成任務後，調度程序將使用 http 方法向配置的端點發送通知POST詳細說明執行了什麼操作及其成功/失敗。

您還可以配置即將到來的任務的預先通知。有關指定通知 URL 和設置的詳細信息，請參閱 實時 API 參考 ，並註意為 SEP 作業安排開始/停止時間和安排剪輯的區別：

啟動/停止調度程序
  • 通知 URL 定義在請求主體對象的頂層
  • 通知安排在activation和deactivation對象（事件發送通知前的秒數）

例子

{
	"job_id": "your Job ID",
	"activation": {
		"time_utc": 1612274100,
		"notification": 600
	},
	"deactivation": {
		"time_utc": 1612281600,
		"notification": 600
	},
	"description": "My Tuesday broadcast",
	"notification_url": "https://example.com/live/jobstartstop/callbacks"
}
剪輯調度程序
  • 通知 URL 定義在請求主體對象的頂層
  • 通知安排在clip對象（任務開始發送通知前的秒數）

例子

{
	"job_id":  "your Job ID",
	"description": "My Scheduled Clip",
	"notification_url": "https://example.com/live/clip/callbacks",
	"clip": {
		"output": {
			"label": "My Scheduled Clip",
			"start_time": 1612878900,
			"end_time": 1612879800,
			"videocloud": {
				"video": {
					"name": "My Scheduled Clip"
				}
			}
		},
		"time_utc": 1612879800,
		"notification": 600
	}
}

通知機構

當服務器向您發送通知時notification_url，請求將包含一個 JSON 正文。這些字段在下表中有詳細說明。

通知正文字段
行動 動作名稱。查看 操作
工作流程 操作完成後更新工作流程。結構將取決於工作流類型。
錯誤 如果在完成操作時發生錯誤，此字段將包含錯誤。值取決於操作類型。

動作

下表按工作流類型詳細說明了操作。

動作
名字 工作流類型 描述
notify-activate jobstartstop 注意通知，您的工作將很快被激活。
activate jobstartstop 作業激活完成。如果"error"存在，激活失敗，取消激活。
notify-deactivate jobstartstop 注意通知，您的工作將很快被激活。
deactivate jobstartstop 作業停用完成。如果"error"存在，停用失敗。
notify-clip clip 注意通知，您的 Clip 將很快被請求。
clip clip 剪輯請求完成。如果"error"存在，請求失敗。