서문
시스템을 사용하기 위해 OAuth에 대해 알 필요는 없으며 아래에서 시작하는 데 필요한 모든 사항을 설명합니다. OAuth에 대한 자세한 개요는 Brightcove OAuth API서류.
OAuth 인증을 사용하려면 다음 단계를 따르세요.
작업 할 때Player Management API , 기본 인증을 사용할 수도 있습니다. 자세한 내용은단계별 : 플레이어 관리문서.
클라이언트 자격 증명 가져오기
OAuth를 사용하려면 먼저 클라이언트 자격 증명 ( client_id
과client secret
). 이러한 자격 증명은 작업중인 계정 및 API 작업에 유효합니다. 향후 사용을 위해 이러한 자격 증명을 안전한 장소에 저장하는 경우에 한해 일회성 작업입니다.
자격 증명을 얻는 방법에는 두 가지가 있습니다.
권한이 필요한 작업은 다음과 같습니다.
- 선호되는 방법은에 설명 된대로 Studio Admin UI를 사용하는 것입니다. API 인증 자격 증명 관리문서.
- 다음과 같이 cURL을 사용할 수도 있습니다. cURL을 사용하여 클라이언트 자격 증명 얻기문서.
- Studio에서 :
플레이어 관리 API 권한 - OAuth API를 통해 자격 증명을 얻으려면 :
video-cloud/player/read
video-cloud/player/all
- Studio에서 :
다음으로 OAuth 액세스 토큰을 받아야합니다.
액세스 토큰 얻기
이전 단계에서 얻은 클라이언트 자격 증명은 액세스 토큰을 요청하는 데 사용됩니다 ( access_token
), API 호출을위한 권한을 제공합니다. 이 토큰은 5 분 동안 만 유효하므로 대부분의 경우 각 API 호출에 대해 하나씩 가져와야합니다.
cURL을 사용하여 액세스 토큰을 얻으려면 다음 단계를 따르십시오.
-
명령 줄에서
export
클라이언트 ID 및 클라이언트 시크릿 값을 설정하는 명령.export CLIENT_ID=your client id value export CLIENT_SECRET=your client secret value
-
다음 cURL 문을 복사하여 명령줄에 붙여 넣은 다음 Enter 키를 누릅니다.
curl -s --user $CLIENT_ID:$CLIENT_SECRET --header "Content-Type: application/x-www-form-urlencoded" --data "grant_type=client_credentials" https://oauth.brightcove.com/v4/access_token
-
응답은 다음과 비슷해야 합니다.
{"access_token":"AGUq5IQzLzrRvs8CNbhYlBFeB1_B6jTJrcE8grFHEJaPRsPeEg3-S_Apgv8VKiZ-nzxjDGtKwAco9q3z8tdzrxq76k6B9tUXk9HYQOIYgqziWbuvA50VaW8AK2MQFc0G3-woH_kgQxNQUaVNEpE1sePE9GUb2u9FfeQyLw8XQE_QfriYwkkcQoaGOusoIpujx8H6dLFovPuH5F5N3OSxNYhNZrdOhJwkdN7oe076j3xwNRarHn5IRPYKzjOMbqDk552aAhJxo2pYWoDh3q63pBrzre4Bj1rCHKJPifPEMrgPWzG1Uz1BPhQb5_ubr4P8mtnhCjJn4zzT_1-C8ActMUof45kVFhG4VTWRA8rh05THqEBj_TzPIR7L1t5oHhLo5ziILNSp7mZRM3folvYJC6YIhY7M4qLNGR5iq3nerlv5Ufr_bI-1AnP7a68JasawDpZxjfoGf3h6cwIZJr2uG_iU4FO9Ig-Gotaqv5mLWmUgR-DJ3sfRADc", "token_type":"Bearer", "expires_in":300}
액세스 토큰을 사용하면Player Management API .
요구Player Management API
OAuth를 사용하여Player Management API , 이전 섹션에서 생성 한 액세스 토큰이 필요합니다. 이 토큰은 5 분 후에 만료되므로 액세스 토큰이 만료 된 경우 이전 섹션 단계를 반복해야 할 수 있습니다.
cURL을 사용하여 플레이어 구성 정보를 얻으려면 다음 단계를 따르십시오.
-
명령 줄에서
export
액세스 토큰, 계정 ID 및 플레이어 ID 값을 설정하는 명령입니다.export ACCESS_TOKEN=your access token value export ACCOUNT_ID=your account id export PLAYER_ID=your player id
-
다음 cURL 문을 복사하여 명령줄에 붙여 넣은 다음 Enter 키를 누릅니다.
curl --header "Content-Type: application/json" --header "Authorization: Bearer $ACCESS_TOKEN" --request GET https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration
-
응답은 다음과 비슷해야 합니다.
{"video_cloud":{"video":null,"policy_key":"BCpkADawqM3VpA66ktTO5bdLTmz6kLGMvGZrSyp-YTvbc4MHllmDmuwzEseO1uTeYYRqygGHhB_MgMaM6ndh5ch-cKYtMFx3LerHyziID8M19b162eeIXKYaxDf8uh4OsLTxVijM-qT1N5QR"}, "stylesheets":["http://solutions.brightcove.com/bcls/brightcove-player/disabled-scrubber/disabled-scrubber.css"], "scripts":[],"plugins":[], "player":{"template":{"version":"1.14.22","name":"single-video-template"}}, "autoadvance":0}
귀하가 할 수있는 모든 요청에 대해 알아 보려면Player Management API , 참조 Brightcove Player Management API참조 문서.