Difference between revisions of "GetLiveSchedulesById"

From Gvp-public
Jump to navigation Jump to search
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Api_Method_Spec|
 
{{Api_Method_Spec|
Description=Returns the list of live schedules (as array of [[EpgLiveSchedule]] objects) for the provided list of schedules (IDs), adult filter and program type filter. It is also possible to restrict the list of results to only include "highlighted" (rating > 0) contents, and to sort the schedule lists by rating value (descending).
+
Description=Returns the list of live schedules (as array of [[EpgLiveSchedule]] objects) for the provided list of schedules (IDs), adult filter and program type filter. It is also possible to restrict the list of results to only include "highlighted" (rating > 0) contents.
  
 
|Parameters=
 
|Parameters=
Line 8: Line 8:
 
|ParamRequired=required
 
|ParamRequired=required
 
|ParamDescription=A valid token for identifying the API session context and logged user.
 
|ParamDescription=A valid token for identifying the API session context and logged user.
}}
 
{{Api_Parameter|
 
ParamName=offset
 
|ParamType=int
 
|ParamRequired=optional
 
|ParamDescription=Index of the initial result of the list, begins with 0
 
}}
 
{{Api_Parameter|
 
ParamName=limit
 
|ParamType=int
 
|ParamRequired=optional
 
|ParamDescription=Quantity of results showed, with the maximum of 100
 
 
}}
 
}}
 
{{Api_Parameter|
 
{{Api_Parameter|
Line 44: Line 32:
 
|ParamRequired=optional
 
|ParamRequired=optional
 
|ParamDescription=If true, only "highlighted" contents (rating>0) are returned (default = false)
 
|ParamDescription=If true, only "highlighted" contents (rating>0) are returned (default = false)
}}
 
{{Api_Parameter|
 
ParamName=highlightsSorting
 
|ParamType=[[HighlightsSorting]]
 
|ParamRequired=optional
 
|ParamDescription=Sorting criteria (default = 0; contents/schedules are not sorted by rating)
 
 
}}
 
}}
  
 
|Returns=
 
|Returns=
Returns a JSON object with a list of [[EpgLiveSchedule]].
+
Returns a JSON object with an array list of [[EpgLiveSchedule]].
  
 
'''Example:'''
 
'''Example:'''
  
 
{
 
{
:  "Offset": 0,
 
:    "Limit": 10,
 
:    "Count": 48,
 
 
:    [ Array of [[EpgLiveSchedule]] objects ]
 
:    [ Array of [[EpgLiveSchedule]] objects ]
 
}
 
}
Line 85: Line 64:
 
{{!}} Harley Cabral
 
{{!}} Harley Cabral
 
{{!}}- valign="top"
 
{{!}}- valign="top"
! 3.1
+
! 3.2
{{!}} Included parameters for program_type and highlights filtering, and highlights sorting
+
{{!}} Included parameters for program_type and highlights filtering; No longer a paginated list, just an array
{{!}} Jose A. Jiménez
+
{{!}} Francisco Milargo
 
{{!}}}
 
{{!}}}
  

Latest revision as of 13:15, 14 October 2015

Description

Returns the list of live schedules (as array of EpgLiveSchedule objects) for the provided list of schedules (IDs), adult filter and program type filter. It is also possible to restrict the list of results to only include "highlighted" (rating > 0) contents.

Parameters

  • token (String, required)
A valid token for identifying the API session context and logged user.
  • liveSchedulesIds (array of int, required)
List of live schedules to retrieve
Adult filter to apply to the list (default = all)
Filter results to only include the provided program type (default = all; no filtering)
  • highlightsOnlyFilter (bool, optional)
If true, only "highlighted" contents (rating>0) are returned (default = false)


Returns

Returns a JSON object with an array list of EpgLiveSchedule.

Example:

{

[ Array of EpgLiveSchedule objects ]

}


Exceptions

  • None.


Caching

This method is cached.


Known issues

None


Version history

API Version Number Change description Changes author
1.0 Initial method design Harley Cabral
3.2 Included parameters for program_type and highlights filtering; No longer a paginated list, just an array Francisco Milargo


See also