Digiguide.tv API Documentation (BETA)

Digiguide.tv Logo

Programme Preferences

Each programme can have a status that denotes whether it is 'liked', 'disliked' or unset. The status table is below and refered to from the following API end points: /like/, /dislike/, /programmepreferences/:

Status Type
0 Unset
1 Liked
2 Disliked

Programme Likes

Use this API to get or set a programme as 'liked' for the authorised user account. Returns the current 'status' of the programme.

End Point http://api.digiguide.tv/1.2/tv/like/
Supported Responses JSON
Supported Methods GET or POST
URI Scheme Either HTTP or HTTPS requests are supported.
User Authentication Required

Required Parameters

appid=<yourappid> Your unique and secret Application ID
id=<unsigned integer> Valid programme ID as returned from the "Programme" or "Schedules" APIs for example.
When POST request made...
set=<unsigned integer> Value '1' to set a like, value '0' to unset a liked programme.

Successful Response

{ "success": true, "status": 1 }

Programme Dislikes

Use this API to get or set a programme as 'disliked' for the authorised user account. Returns the current 'status' of the programme.

End Point http://api.digiguide.tv/1.2/tv/dislike/
Supported Responses JSON
Supported Methods GET or POST
URI Scheme Either HTTP or HTTPS requests are supported.
User Authentication Required

Required Parameters

appid=<yourappid> Your unique and secret Application ID
id=<unsigned integer> Valid programme ID as returned from the "Programme" or "Schedules" APIs for example.
When POST request made...
set=<unsigned integer> Value '1' to set a like, value '0' to unset a disliked programme.

Successful Response

{ "success": true, "status": 0 }

Programme Status

Use this API to find out the status of a specific programme for the authorised user account or not.

End Point http://api.digiguide.tv/1.2/tv/programmepreferences/
Supported Responses JSON
Supported Methods GET or POST
URI Scheme Either HTTP or HTTPS requests are supported.
User Authentication Required

Required Parameters

appid=<yourappid> Your unique and secret Application ID
id=<unsigned integer> Valid programme ID as returned from the "Programme" or "Schedules" APIs for example.

Successful Response

{ "success": true, "status": 2 }