서문
인제스트 프로파일 API를 사용하면 다음과 같은 작업을 수행할 수 있습니다.
-
계정에 대한 프로필 가져오기
-
새 프로파일 만들기
-
프로파일 업데이트
-
프로파일 삭제
-
계정의 기본 프로필 설정 또는 업데이트
편안한 API
인제스트 프로파일 API는 RESTful API입니다. HTTPS 요청을 수락하고 JSON 응답을 반환합니다.
즉, 루비, 자바, PHP, 파이썬, 자바 스크립트 (AJAX 또는 nodejs를 통해) 등 당신이 선택한 모든 언어로 API를 사용할 수 있습니다 HTTPS 요청을하고 JSON 응답을 처리하기 만하면 됩니다.
기본 URL
Ingest Profiles API의 기본 URL은 다음과 같습니다.
https://ingestion.api.brightcove.com/v1
권한
API 호출은 OAuth2 액세스 토큰을 사용하여 승인됩니다. 토큰은 인증 헤더에 요청과 함께 전달됩니다.
Authorization: Bearer {access_token}
액세스 토큰은 수명이 짧기 때문에 (5 분) 요청할 때마다 하나를 가져와야합니다.
이 연습에서 우리는대리액세스 토큰을 가져온 다음 요청합니다.
연습을위한 설정
설정
두 가지 옵션이 있습니다.
- 샘플 계정으로 연습 수행 (권장)
- 자신의 계정 사용
모든 프로필 가져 오기
계정 프로필 얻기
계정에 대한 모든 프로필을 가져 오려면 엔드 포인트에 GET 요청을합니다.
/accounts/{account_id}/profiles
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles
연습 1: 모든 프로필 가져 오기
다음 GET 요청을 작성하십시오.
프로필 만들기
프로필 만들기
프로필을 생성하려면 엔드 포인트에 POST 요청을합니다.
/accounts/{account_id}/profiles
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles
프로필의 JSON은 요청 본문으로 포함됩니다. 참조프로필 필드 참조프로필, 변환 및 DRM 패키지 필드 용
연습 2 : 프로파일 작성
다음 POST 요청을 작성하십시오.
연습 2 응답
단일 프로필 얻기
ID로 프로필 얻기
ID로 프로필을 검색하려면 엔드 포인트에 GET 요청을합니다.
/accounts/{account_id}/profiles/{profile_id}
에 대한profile_id
, 다음 중 하나를 사용할 수 있습니다.
- 이름 (예 : 균형 잡힌 고화질)
- 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/screencast
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/54de14cce4b0a6d2bf9cb08a
연습 3 : 하나의 프로필 얻기
다음 GET 요청을 만들어 생성 한 프로필을 다시 가져옵니다.
프로필 업데이트
ID로 프로필 업데이트
ID로 프로필을 업데이트하려면 엔드 포인트에 PUT 요청을합니다.
/accounts/{account_id}/profiles/{profile_id}
에 대한profile_id
, 다음 중 하나를 사용할 수 있습니다.
- 이름 (예 : 균형 잡힌 고화질)
- 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/my-test-profile
프로필을 만들 때했던 것처럼 요청 본문에 프로필 데이터를 포함합니다. 프로필 데이터절대로 필요한 것포함id
프로필!
연습 4 : 프로필 업데이트
다음 PUT 요청을 작성하여 작성한 프로파일을 업데이트하십시오 (설명이 업데이트됩니다).
연습 4 응답
프로필 삭제
아이디로 프로필 삭제
ID로 프로필을 삭제하려면 엔드 포인트에 DELETE 요청을합니다.
/accounts/{account_id}/profiles/{profile_id}
에 대한profile_id
, 다음 중 하나를 사용할 수 있습니다.
- 이름 (예 : 균형 잡힌 고화질)
- 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles/my-test-profile
연습 5 : 프로필 삭제
다음 DELETE 요청을 작성하여 작성한 프로파일을 업데이트하십시오 (취소 할 수 없습니다!).
기본 프로필 가져 오기
기본 프로필 가져 오기
계정의 기본 프로필을 가져 오려면 엔드 포인트에 GET 요청을 수행하십시오.
/accounts/account_id/configuration
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
연습 6 : 기본 프로필 가져 오기
계정의 기본 프로필을 가져 오려면 다음 GET 요청을 수행하십시오.
기본 프로필 설정
기본 프로필 설정
계정에 대한 기본 프로필을 설정하려면 끝점에 POST 요청을 수행합니다.
/accounts/account_id/configuration
이 JSON을 요청 본문으로 포함
{
"account_id": {account_id},
"default_profile_id": {default_profile_id}
}
다른 작업과 마찬가지로 의 이름이나 ID를 사용할 수profile_id
있습니다.
- 이름 (예 : 균형 잡힌 고화질)
- 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
연습 7 : 기본 프로필 설정
다음 POST 요청을 수행하여 기본 프로필을 설정합니다 (계정에 이미 기본 프로필이있는 경우 실패합니다. 다음 연습에서 기본값을 업데이트합니다).
연습 7 응답
기본 프로필 업데이트
기본 프로필 업데이트
계정의 기본 프로필을 업데이트하려면 끝점에 PUT 요청을 수행합니다.
/accounts/account_id/configuration
이 JSON을 요청 본문으로 포함
{
"id": {configuration_id},
"account_id": {account_id},
"default_profile_id": {default_profile_id}
}
기본 프로필을 가져 오면 구성 ID가 반환됩니다. 기본 프로필이없는 경우기본 프로필 설정 . 다른 작업과 마찬가지로 의 이름이나 ID를 사용할 수profile_id
있습니다.
- 이름 (예 : 고해상도)
- 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)
예:
https://ingestion.api.brightcove.com/v1/accounts/57838016001/configuration
연습 8 : 기본 프로필 업데이트
계정의 기본 프로필을 업데이트하려면 다음 PUT 요청을 수행하십시오.