SEP 스트림 활성화/비활성화 예약

JobStartStop엔드포인트를 사용하여 기존 라이브 SEP의 활성화 및 비활성화를 예약할 수있습니다. 지정된 시간에 당사 시스템은 귀하를 대신하여 작업을 활성화 및 비활성화하기 위해 필요한 API 호출을 수행합니다.

요구 사항

  • 계정의 라이브 API 키입니다.
  • 라이브 계정에는 스케줄러 재정의가 활성화되어 있어야 합니다.
  • 기존 라이브 작업"static": true (자세한 내용은정적 진입점 작업참조).

스케줄러 만들기

에 시작하는 2시간 짜리 이벤트를 신청한다고 가정해 보겠습니다2021-04-02T14:00:00+00:00 .

타임스탬프는 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"
}

스케줄러 업데이트

당신은 업데이트 할 수 있습니다activation및/또는deactivation작업이pending상태 ( "state": "pending" ). 이 작업을 수행하려면 다음 주소로PUT요청을 보내십시오.

https://api.bcovlive.io/v1/scheduler/jobstartstop/{workflow_id}

헤더는 위에 표시된POST요청의 헤더와 동일합니다.

요청 본문

요청 본문 객체에는activation및/또는deactivation필드만 포함하십시오.

예를 들어 예정보다 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": "https://example.com/live/jobstartstop/callbacks"
	}