The LKUP command requests to the webservice, through POST, to search for new channels.
Channel search returns a list of the first 10 channels that matche the search argument. If the complete list has more than 10 channels, the webservice also returns the tag more, which value is equal to the last of the 10 received tags.
When the more tag is returned in a search result, the APP displays the “More …” button at the bottom of the results list. When the user clicks this button, the APP submits a new search with the argument more, telling the webservice that it wants the next 10 results, and so on.
The search result with the tag more empty, indicates that there are no more results besides the tags listed.
The search also includes the MD5 hash of the channel icon, allowing the APP to get the image of the icon in the local base or request the image through the icon command.
Images of icons obtained should be stored in the local base for future use.
|id||Contains the identification of the Device, no encrypted (Device-ID)|
|key||Contains the temporary AES key encrypted with the public key and encoded in Base64;|
|frame||Contains the XML request, encrypted with the temporary AES key and encoded in Base64.|
In response to the POST, the webservice returns the XML POST response, which should not mistaken with the XML request response, as described below. The POST response XML includes 3 tags:
<?xml version="1.0" encoding="utf-8"?> <followzup> <retcode>return-code</retcode> <retframe>xml-request-response</retframe> <retmd5>md5-hash</retmd5> </followzup>
<?xml version="1.0" encoding="utf-8"?> <followzup> <stp>stamp</stp> <com>lkup</com> <seq>sequence</seq> <chn>channel-arg</chn> <mor>more-tag</mor> </followzup>
<?xml version="1.0" encoding="utf-8"?> <followzup> <chn>channel-tag;flag-private;flag-private-code;md5-icon;presentation-text</chn> <chn>...</chn> <mor>more-tag</mor> </followzup>
XML request response (invalid sequence):
<?xml version="1.0" encoding="utf-8"?> <followzup> <seq>Last-sequence</seq> </followzup>
|7242||Search argument less than 3 characters|
|7999||Webservice under maintenance|