Interfaces

This page collects information about additional web interfaces to botsbot.com. Currently there are 3 types of interfaces:

  • RSS feeds
  • web service apis
  • Botsbot badge


1. RSS

There are several RSS feeds available. Below you can find current list of (English) RSS feeds.

/en/rss/address.php?a={bluetooth address}

/en/rss/lastrss.php?u={member}

/en/rss/rss.php?u={member}&a={bluetooth address}

/en/rss/spotters.php?id={member id}

/en/rss/spottees.php?id={member id}

/en/rss/message.php?id={member id}

/en/rss/message.php?u={member}&passwd={salasana}

Note! All URLs are without {}.


2. Web service apis

There are several REST web service apis already in use, which are not public. This is the current list of public web sevice apis:

/api/match.php?u={member}&a={bluetooth address}

This will return an XML document, which lists all the occurences where user has sbotted the bluetooth address.

XML document has following structure:

< Match>
< Result > True or False depending whether address is sbotted </Result>
< Index > times the address has been sbotted </Index>
< BTName > bluetooth name </BTName>
< Context >
< Time > Unix timestamp, i.e. returns the current time measured in the number of seconds since January 1 1970 00:00:00 GMT </Time>
< Location > location where the address was sbotted </Location>
< /Context>
< /Match>

You can test the api directly with your browser, e.g.: http://www.botsbot.com/api/match.php?u=jaakko&a=000e6d668bcb

Context tags can be more than one depending how many times the address has been sbotted in different locations.


3. Badge

By including following javascript, you can get your last publish information to any web site.

< script type="text/javascript" src="http://www.botsbot.com/js/status.php?u={member}"></script>

In my blog the badge is on the right hand side. It could be better and all proposals are welcome.