KrakenAPI client library
SDK provides simple way to retrieve TV schedule data.
SDK contains few public classes representing API entities:
Entities work very similar to jQuery objects. They encapsulate request building, request executing logic and data collection storage.
Let's look at most basic example - getting list of countries supported by API. This code creates new Region object and gets all records without filtering or sorting.
You are free to get only first two countries. Let`s modify our example.
kraken.Region.create() .limit(2) .findOne(dataReceivedCallback);
API supports paging and to work with it on client side three data retrieval methods are supported:
Maximum possible response (page) size is 128 records and default size is the same.
You can set particular page size by using
It's quite important to get only data you really need, so please, specify fields as following.
kraken.config.region = 'NL'; kraken.Channel.create() .fields(kraken.Channel.TITLE, kraken.Channel.ID) .findAll(dataReceivedCallback);
Most advanced tool for specific data retrieval is filtering. In this example we will get only broadcasts with category equal to sports.
kraken.config.region = 'NL'; kraken.Broadcast.create() .filter(kraken.Broadcast.category.isEqual('sports')) .findAll(dataReceivedCallback);
This will get all channels sorted by title:
kraken.config.region = 'NL'; kraken.Channel.create() .sort(kraken.Channel.title, 'desc') .findAll(dataReceivedCallback);
BTW sorting on Broadcast class instances will not work in beta.
Have a bug? Please create an issue on GitHub!