I fjor lanserte Bitfactory en
mobilapp for å få
tilgang til bensinpriser på landets bensinstasjoner ved å samle
inn prisene på dugnad ved hjelp av mobilapp-ens brukere.
Informasjonen app-ens brukere har samlet inn har så langt kun vært
tilgjengelig for brukerne av app-ene, og API for å hente ut
informasjonen fra andre plattformer har ikke vært publisert. Da
løsningen kom spurte jeg utviklerne om de kunne publisere
API-dokumentasjon og de skulle se på saken, men det har ikke skjedd så
langt. Jeg antar de har vært for travelt opptatt til å publisere
API-dokumentasjon.
Utrolig nok er det i følge
Dagens
Næringsliv og
Finnmark
Dagblad bensinstasjoner som nekter å oppgi prisene sine på
telefon, slik at det ikke finnes en fornuftig måte å få tak i prisene
på uten å samle dem inn på stedet. Flere har dugnader på gang for å
samle inn prisinformasjon om bensin, men så vidt jeg kan se er det kun
dinside.no
og Bitfactorys App som får regelmessige oppdateringer. Dinsides
oversikt er tilgjengelig på web for de som vil følge med, mens
bitfactorys informasjon ikke er like enkelt tilgjengelig.
Jeg tok meg derfor litt tid for å revers-utvikle protokollen for
Bitfactorys mobilapp for å gjøre den innsamlede informasjonen mer
tilgjengelig for flere. Protokollen bruker HTTP og normal
forms-notasjon for POST. Jeg lot en telefon koble seg til mitt
trådløsnett, og satte opp tcpdump til å samle all trafikken mot
www.bitfactory.no, og deretter tittet på alle HTTP-kallene ved hjelp
av wireshark. Her er API-kallene jeg har identifisert så langt.
stasjonsDatabaseUpdateStamp
GET http://www.bitfactory.no/Bensin/ver1.1.stasjonsDatabaseUpdateStamp
Vet ikke helt hva dette API-kallet gjør, men navnet gjør at jeg
tror den rapporterer når listen over stasjoner sist ble endret.
Returverdien er et tall som pr. 2011-12-09 er 1319145491 og
pr. 2012-05-28 er 1336420693. Mitt gjett er at dette er sekunder
siden 1. januar 1970 ala det en finner på Linux, som kan konverteres
til en leselig dato med perl -e 'print
scalar(localtime(1319145491)), "\n"'. Den første verdien
konverterer da til "Thu Oct 20 23:18:11 2011", mens den andre
konverteres til "Mon May 7 21:58:13 2012".
GetXMLDatabase
echo password=XYZXYZXYZXYZX | POST http://www.bitfactory.no/Bensin/GetXMLDatabase.php
Henter ned listen med stasjoner på XML-format. Argumentet er
password som muligens følger med i programpakken og eventuelt
genereres av app-en. Nedlasting med samme passord flere ganger ser
ikke ut til å fungere. Innholdet er ca. 1600 stasjoner, men manglet
bensinstasjonen i min hjemkommune Ballangen da jeg sjekket, så den er
ikke komplett. Formatet på selve listen ser slik ut (klippet):
<?xml version="1.0" encoding="UTF-8"?>
<STASJONSDATABASE>
<STASJON>
<NAME></NAME>
<ADDRESS></ADDRESS>
<ID>0</ID>
<LATITUDE>0.000000</LATITUDE>
<LONGITUDE>0.000000</LONGITUDE>
<COMPANY></COMPANY>
</STASJON>
<STASJON>
<NAME>Statoil Best Eidsvoll Verk</NAME>
<ADDRESS>Gamle Trondheimsvei 339 2074 Eidsvoll Verk</ADDRESS>
<ID>1</ID>
<LATITUDE>60.303902</LATITUDE>
<LONGITUDE>11.168100</LONGITUDE>
<COMPANY>Best</COMPANY>
</STASJON>
[...]
<STASJON>
<NAME>Esso Andenes</NAME>
<ADDRESS>Falcksgate 9, 8480 Andenes</ADDRESS>
<ID>1822</ID>
<LATITUDE>69.320999</LATITUDE>
<LONGITUDE>16.118700</LONGITUDE>
<COMPANY>Esso</COMPANY>
</STASJON>
</STASJONSDATABASE>
GetBanStatus
echo UDID=Android-123456789012345 | POST http://www.bitfactory.no/Bensin/ver1.1.GetBanStatus.php
Vet heller ikke helt hva dette API-kallet gjør. Navnet gjør at jeg
tror den rapporterer om telefonen med UDID oppgitt som argument er
bannlyst fra tjenesten. Bannlysning gjør antagelig at telefonen ikke
kan brukes til å registrere bensinpriser, men det er også mulig det
blokkerer for å se på priser. Eneste POST-argument er UDID, som ser
ut til å være den unike ID-en til en mobil-enhet. Returnverdi er 'NO'
for alle UDID-verdier jeg har testet. Gjetter på at alternativ
returverdi er 'YES', men har ikke sett en slik verdi så langt.
PriserVedStasjoner
echo 'stasjoner=810,364&day=0' | POST http://www.bitfactory.no/Bensin/ver1.1.PriserVedStasjoner.php
Dette kallet henter ut priser registrert på en eller flere
bensinstasjoner. Den tar to POST-argumenter, "stasjoner" som er
kommaseparert liste over stasjons-IDer (numeriske), og "day" som bør
settes til "0" for å få ut informasjon om priser. Usikker på hva
day-tallet betyr, men mistenker det har med hvor langt tilbake i tid
det skal hentes ut informasjon.
Resultatet som kommer tilbake er en kommaseparert liste for hver
enkelt stasjon, med <br> som skillemarkør mellom hver stasjon.
Ikke helt sikker på hva alle feltene er. Her er mine gjett:
FeltBeskrivelse
1 | Bensinstasjons-ID |
2 | Pris for blyfri 95 oktan, flyttall med punktum som desimalskille. |
3 | Klokkeslett da prisen ble oppdatert, format HH:MM. |
4 | Telefon-ID på formen Android-123456789012345 eller hex-kodet streng/MD5-sum |
5 | tall, uviss betydning. muligens relatert til day-verdien. Oppdatering 2012-06-02: Denne verdien er antall bekreftelser en gitt pris har fått. |
6 | Pris for blyfri 98-oktan? |
7 | samme som felt 3 |
8 | samme som felt 4 |
9 | samme som felt 5 |
10 | Pris for disel |
11 | Samme som felt 3 |
12 | Samme som felt 4 |
13 | Samme som felt 5 |
En stasjonsoppføring består dermed av av bensinstasjons-ID og
deretter tre blokker for 95-oktan bensin, 98-oktan bensin og
disel.
PriserVedStasjon
echo 'id=736&day=0' | POST http://www.bitfactory.no/Bensin/ver1.1.PriserVedStasjon.php
Ser ut til å returnere informasjon for en enkelt bensinstasjon.
Formatet er dato på formen "08_12_2011" for 2011-12-08, og noe som ser
ut som samme format som fra PriserVedStasjoner. For stasjoner der
intet er registrert returnerer den "NO RESULTS".
AllePriser
echo day=0 | POST http://www.bitfactory.no/Bensin/ver1.1.AllePriser.php
Returnere liste med av alle stasjoner det er registrert oppdaterte
priser på siste 24 timer (eller er det fra ca. midnatt dagen før?).
Returnerer "NO RESULTS" når listen er tom. Ellers returnerer den en
dato på formen "Thursday_09_12_2011" fulgt av <br> og deretter
en liste med stasjoner på samme format som PriserVedStasjoner.