Query

You can query livatar service to determine if a given user is currently streaming or not.

Building a call

curl http://api.urfastr.net/livatarAPI?q=urfastr/username/johndoe

It is possible to query many users at once as an optimisation. Use qs url parameter and concatenate all the query string together separated with a coma. For example, to query urfastr/username/johndoe and twitter/username/janedoe in a single call, do:

curl http://api.urfastr.net/livatarAPI?qs=urfastr/username/johndoe,twitter/username/janedoe

Query Format

There are various ways to identify the user. They are divided into namespaces:

• UrFastR namespace: you can identify the user with his email urfastr/email/john.doe@example.com or with his username urfastr/username/johndoe
• FaceBook namespace: The user may be identified by his unique id on FaceBook , for example facebook/uid/12345678. Assuming he linked his UrFastR account to FaceBook.
• Twitter namespace: The user may be identified by his username on Twitter , for example twitter/username/johndoe. Assuming he linked his UrFastR account to Twitter.

Feed

There is a feed available for livatar Events. The url is http://api.urfastr.net/livatarFeed.
You can control the output with the following parameters:

• since date
  Return only the events which occured strictly after a given date. The parameter is a date parsable by php strtotime
• until date
  Return only the events which occured before or at a given date. The parameter is a date parsable by php strtotime
• username name
  Return only the events which occured due to this username.
• limit number
  Return only a given amount of events. It defaults to 10 and can not be greater than 50.
• geocode latitide,longitude,radius
  Return only the events which occured within a given radius of the given latitude/longitude, where radius units must be specified as either "mi" (miles) or "km" (kilometers)