Ingest settings
If you wish to use a non-IBM encoder for broadcasting (like Flash Live Media Encoder, Wirecast, Tricaster, etc.), you will need a stream key or channel key to authenticate with IBM Video Streaming. This will prove that broadcasting to that particular channel is allowed. Also, you need to get the ingest point where your device or application should connect.
Get ingest settings
GET https://api.video.ibm.com/channels/{channel_id}/ingest.json
Parameters
This request has no parameters.
Success response
Upon success a response with HTTP status “200 OK” is returned with the following key-value pairs under an ingest element.
| KEY | TYPE | DESCRIPTION |
|---|---|---|
rtmp_url | string | Ingest URL of the channel |
rtmps_url | string | Secure ingest URL of the channel |
channel_key | string | Permanent authentication key for broadcasting on the specified channel |
streaming_key | string | Temporary authentication key for broadcasting on the specified channel. This expires after 10 minutes. If you request again before it expires the expiration period of the original key will extend by an additional 10 minutes. |
Error responses
Possible error responses:
| HTTP RESPONSE CODE | ERROR VALUE | ERROR CONDITIONS |
|---|---|---|
| 401 Unauthorized | invalid_token | The provided access token is missing, revoked, expired or malformed |
| 403 Forbidden | lack_of_ownership | The API user is not allowed to manage the given channel |
| 503 Service Unavailable | There is a temporary error on the server which makes it impossible to serve the request |