Rajapintoja

Tänne on tarkoitus kerätä tietoa botsbot.com palvelun web rajapinnoista, joita kuka tahansa voi käyttää omiin tarkoituksiinsa.

Tällä hetkellä palveluun on olemassa kolmenlaisia rajapintoja:

  • RSS feedit
  • Web palvelu rajapintoja (eli web service api)
  • Badge


1. RSS

Palvelussa on lukuisia RSS feedejä tarjolla, joilla sekä rekisteröityneet että rekisteröitymättömät käyttäjät voivat seurata haluamallaan tavalla tietoa tai integroida sitä muihin palveluihin ja webbisivuihin.

Alla lista nykyisistä RSS feedeistä.

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

/rss/lastrss.php?u={käyttäjä}

/rss/rss.php?u={käyttäjä}&a={bluetooth osoite}

/rss/spotters.php?id={käyttäjän id}

/rss/spottees.php?id={käyttäjän id}

/rss/message.php?id={käyttäjän id}

/rss/message.php?u={käyttäjä}&passwd={salasana}

Huom! Kaikki URL:it ilman aaltosulkuja {}.


2. Web rajapinnat

Palvelun tietoihin on olemassa lukuisia REST tyylisiä web rajapintoja jo käytössä, jotka eivät vielä ole julkisia. Ohessa lista julkisista web rajapinnoista:

/api/match.php?u={käyttäjä}&pw={käyttäjän salasana}&a={bluetooth osoite}

Palauttaa XML dokumentin, jossa kerrotaan mahdolliset paikat ja ajat missä käyttäjä on sbotannut bluetooth osoitteen. Riippuen onko käyttäjän salasana mukana annetaan joko kaikki tiedot tai pelkästään milloin viimeksi käyttäjä osoite ovat tavanneet.

XML dokumentti on muotoa:

< Match>
< Result > True tai False riipuen onko laitetta sbotattu </Result>
< Index > kuinka monta kertaa laite on sbotattu</Index>
< BTName > bluetoothlaitteen nimi </BTName>
< Context >
< Time > Unix aikaleima eli aika sekunteina tammikuun 1 1970 00:00:00 GMT ajasta </Time>
< Location > paikka missä sbotattu </Location>
< /Context>
< /Match>

Kokeile suoraan selaimella esim.: http://www.botsbot.com/api/match.php?u=jaakko&a=000e6d668bcb

Noita Context tagejä voi olla useampi riippuen kuinka monessa eri paikassa laite sbotattu


3. Badge

Lisäämällä omaan webbisivuusi oheisen javascriptin saat oman viimeisen päivityksen näkyviin webbisivullesi.

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

Omassa blogissani on tuo badge josta näkyy miltä se tällä hetkellä näyttää. Sitä voisi paremmaksikin tehdä ja ehdotuksia otetaan vastaan.