ioio.tv APIs

# Listings Single List

API call format

GET /broker/listings/{channel}/{start}

Description

This call gets single listing at specified "start" time.

Precondition

  • No authorization token is needed.
  • Mandatory elements (should be specified):
    • <channel_guid> - valid channel guid. Take a specific channel guid using Channels List API call.
    • <listing_start> - valid Unix timestamp. This value should be equal to existing listing's "start" time. Take a specific listing "start" time using Listings List API call.

Postcondition

  • On success response code should be 200
  • On success the listing which "start" time is equal to parameter "listing_start" time is returned.
  • On failure an error will be returned with the right error code and description.

Example:

[Request] GET https://<base_api_url>/listings/<channel_guid>/<listing_start>
[Request Headers] {"Content-Type":"application/json","Accept":"application/json","Authorization":"<IdToken>"}
[Response] 200
[Response Headers] {"Content-Type":["application/json"],"Content-Length":["..."],"Connection":["keep-alive"],"Date":["..... GMT"],"x-amzn-RequestId":["....."],....]}
[Response] 
{
  "status": true,
  "data": 
    {
		"channel": "<channel_guid_01>",
		"start": <start_timestamp>,     //equal to <listing_start>
		"title": "<channel_title>",
		"description": "<channel_description>",
		"color": "#2ECC70",
		"end": <end_timestamp>
    }
}

← Listings Store →