빠른 시작: 인제스트 프로파일 API

서문

인제스트 프로파일 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 요청을 수행하십시오.

요청 제출

(응답은 다음 슬라이드에 나타납니다.)

연습 8 응답