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

    개요 : Delivery System API

    이 항목에서는 Delivery System API저장소라고하는 파일 그룹의 관리 및 배포를 허용합니다. 이 시스템은 저장 공간으로 설정되었습니다 player 사용자 정의 빌드 플러그인의 JavaScript 및 CSS 파일과 같은 관련 파일.

    개요

    전달 시스템과 관련된 파일은 REST API를 통해 관리되며 Git를 통해 선택적으로 관리됩니다. 이 파일들은 players.brightcove.net API 호출 또는 "git push"를 통해.

    네가 그 일을 겪지 않았다면 단계별 : Delivery System API, 당신이 거기에서 시작하는 것이 좋습니다. 보안을 설정하고 시스템의 기본 사항을 배우고 여기에서 더 자세히 살펴볼 준비를하십시오.

    또한 API 참조.

    전달 시스템 REST API

    전달 시스템 API는 리포지토리 (Repos라고도 함)를 중심으로 배치됩니다. Repos를 추가, 가져오고 나열 할 수있는 REST API 그룹을 통해 repos를 관리 할 수 ​​있습니다. REST API 호출을 사용하여 repos에있는 파일을 조작 할 수도 있습니다.

    명령 줄 도구 컬을 사용하여 REST API를 사용할 수 있습니다. REST API는 성공에 대한 다음 정보가 포함 된 JSON 형식의 응답을 반환합니다.

    • name : 저장소 이름. 이는 REST API URL에있는 이름과 같습니다.
    • public_url : repo 파일을 볼 수있는 기본 URL입니다.

    그리고, 단계별 : 배달 시스템 사용법에 대한 실용적인 가이드를 제공합니다. Delivery System APIs.

    인증

    둘 중 하나를 사용하여 자신을 인증 할 수 있습니다. OAuth 액세스 토큰 또는 Brightcove 사용자 이름과 비밀번호를 사용한 기본 인증을 통해. 표준 OAuth 액세스 토큰은 API를 프로그래밍 방식으로 사용하는 데 사용해야하지만 기본 인증 경로는 명령 줄 사용 및 시작이 훨씬 쉽습니다.

    우리는 기본 인증을 단계별 예. 대신 액세스 토큰을 사용하려면 다음을 변경하십시오.

        --user $EMAIL

    받는 사람 :

        --header "Authorization: Bearer $ACCESS_TOKEN"

    API 오류 응답

    REST API 호출에 문제가있는 경우 JSON 형식으로 반환 될 수있는 여러 가지 가능한 오류 응답이 있습니다.

    • 기존 API 호출의 철자를 포함하여 존재하지 않는 API를 호출하려고하면 404의 상태 코드와 잘못된 수행에 대한 유용한 메시지가 표시됩니다.
    • 전화를 인증하거나 인증 할 수없는 경우 403 상태 코드가 표시됩니다. 유효한 액세스 토큰을 갖출 수 있도록 OAuth 가이드를 다시 시도해보십시오.
    • GET 또는 PUT 이외의 메소드를 사용하려고하면 응답에 405 상태 코드가 포함됩니다.
    • 요청을 처리하는 데 문제가있는 경우 500 상태 코드와 표준 Brightcove 오류 응답이 표시됩니다.

    위에서 언급 한 표준 Brightcove 오류 응답은 error_code 및 메시지 속성이 포함 된 JSON 응답입니다. 오류 코드는 다음 중 하나입니다.

    • INVALID_LOGIN_CREDENTIALS: 기본 인증을 사용할 때 제공된 사용자 이름과 암호가 유효하지 않습니다.
    • ACCESS_TOKEN_ERROR: 주어진 액세스 토큰이 유효하지 않습니다.
    • INVALID_API_CALL: API 호출이 제대로 포맷되지 않았습니다.
    • NOT_FOUND: API 호출이 알려진 리소스를 가리키고 있지 않거나 제대로 포맷되지 않았습니다.
    • NO_PUT_CONTENTS: 내용 키가있는 다중 파트 양식을 사용하여 repo 파일을 PUT해야합니다.
    • CREATE_REPO_ERROR: Repo 생성 중 오류가 발생했습니다.
    • GET_REPO_ERROR: Repo를 가져 오는 중에 오류가 발생했습니다.
    • GET_REPOS_ERROR: 모든 repos를 가져 오는 중에 오류가 발생했습니다.
    • UNCAUGHT_ERROR: 잡히지 않은 오류로 인해 실패했습니다.
    • UNKNOWN_ERROR: 관련 오류 코드가없는 오류가 발생했습니다.

    제한 사항


    12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지