Rate limiting

Obtain credentials

Like most of Brightcove's RESTful APIs, the Dynamic Ingest API requires OAuth access tokens to authorize requests. In order to get access tokens, you first need to obtain client credentials with permissions for kinds of operations you want to request. This quick start makes API requests on a Brightcove Learning Services sample account, so you will not need to obtain credentials here, but you should understand what's happening. The CodePen sends the API request information to a proxy similar to this one. The proxy accesses client credentials from a private location and uses them to generate a temporary access token using the OAuth API and then makes the API request and returns the response data.

To try requests on your own account, get your client credentials and use one of our API testing tools

To obtain your credentials follow the instructions in Managing API Credentials. This is the recommended way of obtaining your client credentials. Remember that using Dyanamic Ingest requires making one CMS API POST request as well, so in addition to ingest permission, you need at least video/write permissions:
Required Permissions

Use the Studio Admin Tools to get client credentials. You can also obtain credentials using the OAuth API, following the instructions in one of the guides listed below.

Proxy code

In order to build your own version the sample app on this page, you must create and host your own proxy. (The proxies used by Brightcove Learning Services only accept requests from Brightcove domains.) A sample proxy, very similar to the one we use, but without the checks that block requests from non-Brightcove domains, can be found in this GitHub respository. You will also find basic instructions for using it there, and a more elaborate guide to building apps around the proxy in Using the REST APIs.