지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

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

    이 항목에서는 In제스트 프로필 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 응답