소개
Ingest Profiles API를 사용하면 다음을 수행할 수 있습니다.
-
계정에 대한 프로필 가져오기
-
새 프로필 만들기
-
프로필 업데이트
-
프로필 삭제
-
계정의 기본 프로필 설정 또는 업데이트
편안한 API
Ingest Profiles API는 RESTful API입니다. HTTPS 요청을 수락하고 JSON 응답을 반환합니다.
즉, Ruby, Java, PHP, Python, JavaScript(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로 프로필을 검색하려면 엔드포인트에 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로 프로필을 업데이트하려면 엔드포인트에 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 요청을 수행합니다.