User Streams API Preview
Med REST APIet så finns det rate limits (som startar med 350 anrop/timmen), men eftersom User Streams APIet endast är en öppen HTTP uppkoppling så finns det inga sådana begränsningar. APIet är tillgängligt för alla att experimentera med, men det är inte tillåtet att släppa produkter som använder det ännu eftersom APIet är i preview. För tillfället så är det endast TweetDeck och Echofon som har tillgång till det nya APIet för produktion, vill du testa deras User Stream previews så måste du anmäla dig (här för TweetDeck och här för Echofon). Vanliga dödliga (= utvecklare som inte jobbar för TweetDeck eller Echofon) kommer troligtvis att kunna börja använda User Stream APIet på riktigt i slutet av året.

Site Streams API kommer snart
Eftersom många klienter kommer att använda det nya User Stream APIet så kommer det att finnas mer kapacitet för Twitters REST och Search API. Detta kommer förhoppningsvis att leda till större stabilitet för dessa APIer vilket är en bra nyhet för alla oss som använder dem. Om man behöver ha realtidsdata för flera användare, dvs flera User Streams, så kommer det ytterligare ett nytt Twitter API som heter Site Streams. Ännu finns inte några detaljer om när det kommer att finnas tillgängligt eller hur det kommer att funka.

Flattr API snart här
Med Flattr så kan man ge dricks till i micropayment form till bloggare och annat som man gillar på nätet. Flattrs REST API är snart klart och de letar efter partners att integrera med, så om du har en tjänst som skulle kunna passa med Flattr så kontakta dem pronto.

Open Street Maps + Bing = sant
Open Street Maps crowdsourcar (fint svenskt ord) skapandet av kartor, och är på sina ställen mycket mer detaljerat än tex Google Maps. Nu finns Open Street Map tillgängligt som ett lager i Bing Maps. Hoppas samma integration är på väg i Google Maps, men det kanske är för mycket att hoppas på.

Sweden Social Web Camp
Om bara 8 dagar så är det dags för SSWC och jag kommer att vara där. Som uppvärmning innan tältlägret på Tjärö så kommer jag att ta mig samman och skriva fler inlägg under den kommande veckan. Ska du på SSWC och vill snacka API eller något annat så är det bara att säga till (@andreaskrohn)!

Svenska myndigheter har stora mängder data som hittills har varit svår (för att inte säga omöjlig i många fall) att komma åt. Tänk på hur antalet vädersajter har exploderat på senaste, till stora delar tack vara norrmännens gratis statligt finansierade väder API från yr.no. Hur hade det sett ut om samma data var tillgängligt gratis (eller billigt, vilket det inte är nu) i ett användbart format från SMHI? Eller för den delen om data från alla svenska myndigheter var allmänt tillgänglig?

Från och med idag så är det faktiskt lag på att myndigheter ska göra sin data tillgängligt på ett enkelt sätt (= XML, RSS, REST etc), idag så börjar nämligen PSI-lagen gälla. Myndigheterna får endast ta betalt för datan i den mån att de täcker sina kostnader, men eftersom det faktiskt inte kostar många utvecklingstimmar att tillhandahålla ett API till redan existerande system så borde det inte kosta särskilt mycket att använda dessa tjänster.

Nu är det bara att hoppas att myndigheterna verkligen följer denna lag. För att pusha generaldirektörerna lite så har Jonas Lejon och Joakim Jardenberg författat ett öppet brev till dem:

Kära generaldirektörer, låt oss tillsammans göra världen bättre!

Ni sitter sedan många år tillbaka på stora mängder data som är intressant ur flera aspekter. Det handlar om information som vi skattebetalare redan betalt för. Olika aktörer i samhället kan vidareutnyttja information för olika ändamål, t.ex. genom skapandet av nya e-tjänster, såväl kommersiella och ideella. Men ofta har det varit förknippat med stora kostnader och svårtillgängliga lösningar. Äntligen ser vi en ändring komma till stånd.

Att vi entreprenörer kan ta del av denna information även elektroniskt har vunnit laga kraft sedan idag, den 1:a juli 2010. Den så kallade PSI-lagen (Prop. 2009/10:175) öppnar upp för stora möjligheter att skapa tjänster som förbättrar vardagen för oss alla.

Att ni själva sitter på kunskapen att förädla denna information i viss mån är mycket möjligt, rent av sannolikt, men om fler får möjlighet att jobba tillsammans så kommer garanterat resultaten att bli ännu bättre. Det saknas sannerligen inte internationella exempel på de effekter man får av att släppa publikt data tillgängligt för vidareutnyttjande.

Vi vill därför uppmana alla myndigheter och deras chefer att snarast börja arbeta i PSI-direktivets anda och uppfylla den intention som lagen speglar. Citerar från regeringskansliets sida om PSI – vidareanvändning av information:

”Syftet med lagen är att främja utvecklingen av en informationsmarknad genom att underlätta enskildas användning av handlingar som tillhandahålls av myndigheter.”

För att detta ska bli verklighet krävs i praktiken ett API till era tjänster. Vi vill därför med detta brev uppmärksamma er på behovet av att ni skyndsamt öppnar upp en sådan möjlighet. Först då kan vi börja jobba på allvar, och först då kan både ni, vi, lagstiftarna och samhället se den fulla nyttan av den utveckling som startar nu. Vi är många som är villiga att hjälpa till, så se det här brevet också som en utsträckt hand. Dialogen är igång, nu är bollen er.

Ovanstående text är i huvudsak författad av Jonas Lejon (ansvarig bland annat för tjänsten govdata.se), bearbetad av Joakim Jardenberg (bland annat projektledare för Makten och Öppenheten) och helt fri att kopiera, bearbeta och vidarebpublicera enligt CC0.

Google Buzz API
Googles konkurrent till Twitter har nu äntligen fått ett API. Nu kan man söka bland statusuppdateringar, posta statusuppdateringar, hämta och uppdatera användarprofiler, hämta en användares social graph etc. Buzz blev snabbt integrerat i TweetDeck, Seesmic och andra Twitterklienter. Sedan Google klantigt introducerade Buzz så har inte så mycket hänt, kanske kan APIet ge Buzz lite välbehövlig hjälp att få fler aktiva användare.

BigQuery API
Med detta API så kan man analysera väldigt stora datamängder via SQL (eller en SQL-dialekt om man ska vara exakt). Än så länge är BigQuery APIet inte öppet för alla och det går inte att ladda upp sin egen data. De datamängder de tillhandahåller är bla information om artikeluppdateringar från Wikipedia på 314 miljoner rader och data om internetuppkopplingar på 60 miljarder rader – så det är verkligen ordentliga mängder data som detta API kan hantera.

Google Latitude API
Google Latitude låter en hålla reda på sin egen och sina vänners geografiska position, nu kan man använda detta API för att integrera Latitude i sina egna appar.

Google Moderator API
Med detta REST API så kan man samla in ideer, förslag och rekommendationer från en stor mängd användare och sedan låta användarna rösta på vilken som är den bästa ideen.

Google Font API
Detta API gör det enkelt att använda andra typsnitt än standard webbtypsnitten på vilken webbsida som helst. Allt man behöver göra är att importera en javascript fil och ange vilken font i Google Font Directory som du vill använda (lite enklare än Flash replacement).

Ladda upp data
Med Predictions API så kan man göra förutsägelser baserat på mönster i en stor datamängd, tex produktrekommendationer (please lovefilm ta en titt på det här!) eller hitta spam (något för Twitter). Först laddar man upp sin träningsdata till Google Storage (deras konkurrent till Amazon S3). Denna data måste vara formaterad i key-value pairs – om man laddar upp en massa emails så ska alltså alla mail som nämner hemliga Nigerianska bankkonton vara märkta som spam (Google använder detta API för att hitta spam redan).

Träna systemet
När man har laddat upp all sin data så kör man Predictions APIets träning så att APIet kan identifiera mönster. Exakt hur detta går till går inte Google in på, men tydligen har de ett stort antal machine learning algoritmer att välja på och de väljer automatiskt den algoritm som passar bäst för den givna datamängden.

Fråga systemet
Slutligen så kan man skicka in en fråga, tex texten på ett nytt email, och få tillbaka en förutsägelse (i detta fall om det är spam eller inte). Har man använt en stor mängd data av bra kvalitet så verkar man kunna få rätt bra resultat enligt vad jag har sett. Allt detta kan göras via REST, så det bör inte vara några större problem att integrera i vilken applikation som helst (när man får tillgång till APIet dvs).

För mer detaljer om detta högintressanta API så ta en titt på denna video. De börjar presentera Predictions API efter ca 25 minuter…

Bland annat så kommer presentationen att täcka hur man kan komma åt resurser på sin mobiltelefon via REST APIer, alltså hur man kan använda sin telefon som en web service. Iden är att utvecklare ska kunna använda en mobiltelefons kamera precis lika lätt som de kan hämta bilder från Flickr eller att skicka SMS från en mobiltelefon precis lika lätt som det går att skicka meddelanden via Twitter. Kort sagt så kommer mobiltelefonen bara att vara en tjänst bland andra och det kommer att finnas ännu fler möjligheter att utveckla användbara och värdefulla applikationer.

Så om du ska till SWDC så boka in ”The Phone in the Cloud” under dag 2 av konferensen i din kalender!

Filtrera på butik, köpcentrum eller geografi
Det finns två format man kan få data i, antingen via ett RSS2.0 feed som innehåller något begränsad information om varje erbjudande eller via rabatten.ses eget format RabattenAdRSS som innehåller fullständig information om erbjudanden. Oavsett vilket format som man vill ha informationen i så krävs endast ett HTTP-anrop, inga API-nycklar eller annan identifikation behövs. Varje anrop kräver parametern ”mode” som anger hur man identifierar vilka butiker man vill ha information om, ”mode” har följande möjliga värden:

• store eller snabbkod_store – endast erbjudanden från en angiven butik som sedan idenfieras med parametrarna storeid eller snabbkod
• mall – endast erbjudanden från butiker i ett givet köpcentrum som identifieras med parametern mallid
• county – endast annonser från butiker i ett visst län som identifieras med parametern countyid
• locality – endast annonser från butiker i en given postort som anges med parametern localityid
• geoip_county – endast annonser från butiker i det län som IP-adressen som anges med parametern ip är registrerad i
• geoip_location – endast annonser från butiker i en postort som IP-adressen i parametern ip är registrerad i

Via http://www.rabatten.se/rss.aspx?format=mall så får man tag på  alla köpcentrum som rabatten.se har registrerade. Än så finns inget enkelt sätt att få tag på storeid, men det jobbar Rabatten.se på för fullt så det kommer nog inom några dagar.

Exempel API-anrop
För att ta reda på vilka rabatter som Kjell & Co i Gallerian, Stockholm så gör man anropet:
http://www.rabatten.se/rss.aspx?format=rss&mode=store&storeId=1001

För att få reda på alla specialerbjudanden i Stockholm så gör anropet:
http://www.rabatten.se/rss.aspx?format=rabattenadrss&mode=county&countyid=12

I det sista anropet så kommer informationen tillbaka i RabattenAdRSS formatet, dvs XML med så mycket data som möjligt:

...
<ad>
	<adid>374</adid>
	<category>Hälsa & skönhet - Smink & parfym</category>
	<title>BIOTHERM</title>
	<description>club15 BIOTHERM ...</description>
	<ordinaryprice>320.00</ordinaryprice>
	<ordinarypriceunit>st</ordinarypriceunit>
	<rebateprice>0.00</rebateprice>
	<rebatepriceunit>st</rebatepriceunit>
	<compareprice></compareprice>
	<comparepriceunit></comparepriceunit>
	<rentalprice></rentalprice>
	<rentalmonths></rentalmonths>
	<priceisinpicture>False</priceisinpicture>
	<link>http://www.rabatten.se/default.aspx?adid=374&channelid=2</link>
	<image1>http://data.rabatten.se/ads/....jpg</image1>
	<image2>http://data.rabatten.se/ads/....jpg</image2>
	<image3>http://data.rabatten.se/ads/....jpg</image3>
	<store>
		<storeid>1821</storeid>
		<storename>Kicks</storename>
		<storelogo>http://data.rabatten.se/logo....png</storelogo>
		<storestreetaddress>Aniaraplatsen 2</storestreetaddress>
		<storepostaladdress>19147 SOLLENTUNA</storepostaladdress>
		<storecounty>Stockholm</storecounty>
		<storelocationx>59.4272291</storelocationx>
		<storelocationy>17.9525737</storelocationy>
	</store>
	...
</ad>
...

För mer information så ta en titt på Rabatten.ses egen API dokumentation och kodexempel.

Ett API med stor potential
Jag tycker att rabatten.se har ett mycket intressant API där man kan komma åt värdefull data på ett enkelt sätt. Speciellt gillar jag att man kan få fram lokala annonser genom att endast ange IP-adresser i API-anropet. Värdet på APIet är än så länge begränsat om man inte bygger tjänster för de som bara shoppar i Stockholms innerstad, men när Rabatten.se täcker hela Sverige så har detta API potentialen att bli ett av landets mest intressanta.

Första steget som vanligt att skaffa en API-nyckel, sedan är det bara att börja använda APIet. Det finns två sätt att hitta vårdcentraler, antingen anger man en adress eller en position:

http://api.omvard.se/<DIN NYCKEL>/vardgivare/nara/?gatuadress=<GATUADRESS>&postnummer=<POSTNUMMER>&postort=<POSTORT>&format=<XML eller JSON>

http://api.omvard.se/<DIN NYCKEL>/vardgivare/nara/?longitud=<LONGITUD>&latitud=<LATITUD>&format=<XML eller JSON>

Tillbaka får man då XML eller JSON som innehåller namn, adress, kommun och position för de 10 närmsta vårdcentraler från den angivna adressen/positionen, tex:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<vardgivarlista>

    <vardgivare>
        <namn>Vårdcentralen Tågaborg</namn>
        <gata>Tågagatan 38</gata>
        <postort>Helsingborg</postort>
        <postnummer>25439</postnummer>
        <kommun>Helsingborg</kommun>
        <landsting>Skåne</landsting>
        <longitud>12.6906494</longitud>
        <latitud>56.0558033</latitud>
        <url>http://www.omvard.se/skane/vardcentralen-tagaborg</url>
    </vardgivare>

    ...

</vardgivarlista>

Än så länge så har APIet rätt begränsad funktionalitet, helst vill man ju ha tillgång till all den information som OmVård har om vårdinrättningar och vårdköer och dessutom så skulle det vara användbart att kunna skicka in recensioner etc. OmVård verkar öppna till förslag på utökningar och förbättringar av APIet, så har du en brilliant ide som kräver mer av deras API så tveka inte att kontakt dem.

Själv har jag precis spenderat tid med APIet då jag som småbarnspappa vill ha ett enklare sätt att hitta billiga barnkläder, resultatet av det arbetet blev detta inlägg och sajten begagnadebarnkläder.nu (där man kan hitta barnkläder från katvig, molo, Hello Kitty mm). Andra som använder Traderas API är prisjakt och annonskartan.

Application Keys – nycklarna till Traderas API
För att kunna använda Traderas API så krävs att man har registrerat sig på Tradera Developer Center och godkänt Terms of Use och deras Logo Terms of Use. Dessa dokument beskriver hur man ska hantera innehållet från Tradera och hur man ska visa deras logga, i princip så kan man sammanfatta dem med ”var snäll”, ”visa vår logga” och ”visa inte information äldre än 6 timmar” (men jag är ingen advokat så läs dokumenten själva..). När man väl är registrerad så måste man skapa en applikation (bara att ange namn och en kort beskrivning) och så får man en Application Key som man kan använda i alla sina API-anrop.

När man är inloggad i Traderas ”Developer Center” så kan man, förutom att administrera sina applikationer, hantera sin Sandbox. I denna sandlåda så kan man skapa annonser och användare som man kan använda för att testa sina applikationer, det är ju inte alltid man vill gå direkt mot livesajten i sin testning.

APIet är indelat i två delar – PublicServices för de metoder som inte kräver autentisering och RestrictedServices för de metoder som kräver autentisering. Majoriteten av API metoderna finns tillgängliga både via SOAP och REST. Några få finns endast tillgängliga via SOAP, tex när man vill göra en lite mer avancerad sökning efter annonser.

PublicServices – API för att hämta annonser
Med public services så kan man hämta annonskategorier, söka efter annonser baserat på sökord, kategorier etc, hämta information om en specifik annons med mera.

För att få fullständig information om en given annons, vars id man har hämtat via sökningar med andra API-metoder så använd följande REST anrop:
http://api.tradera.com/v2/publicservice.asmx/GetItem?appId=<DITT APP ID>&appKey=<DIN APP NYCKEL>&itemId=<ANNONS ID>

Tillbaka får man då XML som beskriver annonsen i detalj – säljarens beskrivning av varan, nuvarande bud, när slutar auktionen, länk till thumbnail bild, vad finns det för leveranskostnader på varan, vem är säljaren och vem har bjudit högst just nu etc etc.

RestrictedServices – API för att administrera annonser
Med RestrictedServices metoderna så kan man administrera annonser i en användares namn. Användaren i fråga måste då ge sin tillåtelse till detta genom att logga in med sitt Tradera användarnamn och lösenord. Detta görs helt utan att API-utvecklaren får tillgång till användarnamnet och lösenordet, istället ber man om ett Token, sedan hanterar Tradera autentiseringen av användaren och skickar tillbaka detta Token. Ett sådant giltigt token måste sedan skickas med i alla RestrictedServices anrop.

När man väl har ett Token så kan man lägga upp nya annonser, lägga upp bilder, lämna feedback på en köpare eller säljare med mera. Dessa metoder är värdefulla om man vill bygga verktyg som underlättare administrationen av ett stort antal annonser på Tradera.

API begränsningar
Som default så kan man endast anropa varje API-metod 100 gånger inom en 24 timmars period, detta för att undvika för hårt tryck på APIet. Behövs mer anrop så kontakta Tradera med en vettig motivation så verkar det inte vara några större problem att få fler än 100 anrop/dygn.

Har du egen erfarenhet av att använda Traderas API? Har du en coola sajt eller verktyg som använder Traderas API? Dela med dig i kommentarerna nedan eller kontakta mig direkt.