The Media Services Live Stream Provisioning API

The Media Services Live (MSL) Stream Provisioning API enables you to publish live content, and retrieves it for delivering either through Akamai or any content delivery network (CDN). These operations are targeted primarily for OTT applications, but can also be used for other live specific events. Live origin has a publishing workflow and a delivery workflow.

In the publishing workflow, you can directly push content from encoders into Live origin through the Akamai Ingest server.

In the delivery workflow, you can pull the content that was earlier published into origin through a CDN.

The API mirrors the functionality available in the Luna Control Center.

Who Should Use This API

The MSL Stream Provisioning API enables developers and architects to access and provision media streaming using customized interfaces.

To use this API, ensure that your contract includes MediaServicesLive4::MediaServicesLive4.

The API might not work for every user, and works based on the permissions available to the logged-in user.

Getting Started

Before using the MSL Stream Provisioning API for the first time:

  • Contact your Akamai representative to enable it for your account.

  • Review the OPEN API to Get Started on tools that Akamai provides.

  • Review Authorize your Client in Luna to create your OPEN API access credentials and authorizations. As detailed in the OPEN API Identity Model, you then access the API using custom hostnames that looks like this: https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net.

  • Select the following when you configure the OPEN client:
    • API Group: Luna
    • API Name: Media Streaming

Rate Limiting

The MSL Stream Provisioning API imposes a rate limiting constraint. Exceeding that limit results in a 429 error response. Consider this especially when calling successive operations as part of a loop.

Responses have the following headers to specify rate limit infomation:

- `X-RateLimit-Limit`: The maximum number of tokens allowed.
- `X-RateLimit-Remaining`: The number of tokens remaining.

Last modified: 12/6/2017