Well - I've rebuilt the api a little bit, it's not as fully featured as before, but it's a bit more robust, working on an actual web server (Flask python).
It's hosted @
http://2kbcollective.com/api/v1/performers
The default behaviour of the api is to return all gender types and ignores if the user is online or offline, but can be filtered like so:
Code:
http://2kbcollective.com/api/v1/performers/f
Or to return multiple genders:
Code:
http://2kbcollective.com/api/v1/performers/f+c
For reference, the available gender types are:
m - Male
c - Couple
f - Female
s - Transexual
The sorting of these users are descending viewers by default, I'll add other sort methods later on, but that's the only way for now.
To remove all offline users from the query, you can add the QS parameter online=1:
Code:
http://2kbcollective.com/api/v1/performers/f?online=1
The offset command will 'paginate' the results for you, again, the api will only ever return 20 results at a time, so to get the 2nd 'page' of results:
Code:
http://2kbcollective.com/api/v1/performers/f?online=1&offset=20
e.g. Skip the first 20 results and then get the next 20.
Finally, to query a single performer, use the singular form:
Code:
http://2kbcollective.com/api/v1/performer/laurenbrite
this will return that specific user object, so you can use that to check if a user is online or not.