protocol.GetRadioStationsByGenreResponse
This response acts as an acknowledgment to its corresponding request as well as containing a collection of radio stations matching your request parameters. There is meta data included prior to the list to indicate the number of results returned as well as the total matching results in the database. This is useful if you have subset the results.
Parameter | Optional | Max Allowed | DataType | Notes |
---|---|---|---|---|
cid | no | 1 | text | client id. used to track origin of any particular message |
id | no | 1 | database id | genre id |
ixs | yes | 1 | indices | start (i0) and end (i1) index inclusive |
tn | no | 1 | integer | total number matching request |
n | no | 1 | integer | number of results returned |
col | no | 1 | list | list of radiostations. |
Example xml:
<siresp> <cid>Mum</cid> <fn> <getRadioStationsByGenre> <id>584374858</id> <ixs> <i0>0</i0> <i1>9</i1> </ixs> <tn>30</tn> <n>3</n> <col> <rstn> <rdid>432546325432</rdid> <rdnm>1.FM - ABSOLUTE 90's RADIO</rdnm> <wbs>http://www.1.fm</wbs> <rdcv>http://www.apple.com/art.jpg</rdcv> <grnm>90s pop dance rock</grnm> <brt>64kbit/s</brt> <frq>44100 Hz</frq> <dsc>Welcome to 1.FM, the best 90's radio station around 24 hours a day</dsc> </rstn> <rstn> <rdid>432546325432</rdid> <rdnm>1.FM - ABSOLUTE 90's RADIO</rdnm> <wbs>http://www.1.fm</wbs> <rdcv>http://www.apple.com/art.jpg</rdcv> <grnm>90s pop dance rock</grnm> <brt>64kbit/s</brt> <frq>44100 Hz</frq> <dsc>Welcome to 1.FM, the best 90's radio station around 24 hours a day</dsc> </rstn> </col> </getRadioStationsByGenre> </fn> </siresp>