Ursäkta formateringen på SlideShare, min presentation var snyggare i verkligheten.

Att komma igång

För att komma igång och utveckla behövs ett utvecklingskonto, detta erhålls genom att maila Spotify och snällt be de aktivera detta. Det tog cirka ett dygn för Spotify att aktivera mitt konto, efter detta var det fritt fram att knacka kod! De har publicerat en ganska innehållsrik tutorial vilket gör att man snabbt kommer igång, man har lätt ett fungerande Hello World på några få minuter.

En djupdykning

När det sedan är dags för att faktiskt använda deras API lite mer djupgående blir dock allt betydligt jobbigare. Slår man i deras dokumentation inser man ganska snabbt att den inte alls stämmer bra överens med verkligheten. Detta är visserligen något de nämner i dokumentationen, men det är fortfarande tråkigt att det inte finns några bra referenser att vända sig till. T.ex. saknas all dokumentation om trackPlayer, vilket är en väldigt central del för att kunna kommunicera med klienten.

För att kunna gå vidare i utvecklingen började jag dumpa lite objekt med hjälp av console.log(), vilket mynnade ut i följande metoder på Spotify-objektet (det objekt som getSpotifyApi() returnerar):

• core: function core() { return _getModule(_cache, “core”); }
• desktop: function desktop() { return _getModule(_cache, “desktop”); }
• installer: function installer() { return _getModule(_cache, “installer”); }
• require: function require() { return _require; }
• requireAsync: function requireAsync() { return _requireAsync; }
• social: function social() { return _getModule(_cache, “social”); }
• trackPlayer: function trackPlayer() { return _getModule(_cache, “trackPlayer”); }
• whatsnew: function whatsnew() { return _getModule(_cache, “whatsnew”); }

Om man i sin tur dumpar trackPlayer-objektet fås följande:

• addEventListener: function addEventListener() { [native code] }
• canChangeRepeat: function canChangeRepeat() { [native code] }
• canChangeShuffle: function canChangeShuffle() { [native code] }
• getIsPlaying: function getIsPlaying() { [native code] }
• getNowPlayingTrack: function getNowPlayingTrack() { [native code] }
• getPlaybackControlState: function getPlaybackControlState() { [native code] }
• getPlayingContext: function getPlayingContext() { [native code] }
• getRepeat: function getRepeat() { [native code] }
• getShuffle: function getShuffle() { [native code] }
• getVolume: function getVolume() { [native code] }
• playTrackFromContext: function playTrackFromContext() { [native code] }
• playTrackFromUri: function playTrackFromUri() { [native code] }
• removeEventListener: function removeEventListener() { [native code] }
• seek: function seek() { [native code] }
• setIsPlaying: function setIsPlaying() { [native code] }
• setRepeat: function setRepeat() { [native code] }
• setShuffle: function setShuffle() { [native code] }
• setVolume: function setVolume() { [native code] }
• skipToNextTrack: function skipToNextTrack() { [native code] }
• skipToPreviousTrack: function skipToPreviousTrack() { [native code] }

Detta är helt klart ett ganska omständigt sätt att hitta tillgängliga metoder på, men visst fungerar det. All utdata från console.log() dyker (precis som vanligt) upp i inspektorn.

Lite annat smått och gått som finns att tillgå är all källkod som Spotify skickar med i beta-versionen, där finns bland annat ett antal väldigt användbara exempel. Använder man Mac OS X återfinns allt detta i /Applications/Spotify.app/Contents/Resources/cef_views/. Här finns bland annat exempel på hur man kan implementera tabbar och andra trevliga UI-element.

Ett kort exempel

Under tiden jag testade på API:et tog jag fram en (extremt) liten applikation som startar musiken även om någon försöker använda samma Spotify-konto. T.ex. är det detta som inträffar om man försöker använda Spotify på datorn samtidigt som på telefonen. Varningsmeddelandet “Spotify has been paused because your account is used somewhere else” dyker fortfarande upp, men ingen störningen i musiken hörs.

Detta lilla exempel återfinns här och utgör hela 56 rader kod. Trots att det är ett väldigt litet exempel säger det endel om hur kraftfullt API:et faktiskt är.

Slutsats

Till sist måste jag säga att det är riktigt trevligt att arbeta med Spotifys nya API. De har tagit fram ett kraftfullt API tillsammans med en trevlig utevcklingsmiljö och en bra debugger. Det kommer säkerligen komma en hel drös med trevliga applikationer som kommer göra musikupplevelsen på Spotify än bättre. Det jag saknar är en bra referens till alla metoder och objekt, jag hoppas innerligt att Spotify fixar till detta så småningom.

Spotify Apps API

Det är väl få som har missat att Spotify har släppt Spotify Apps och tillhörande Apps API. Med detta Javascript API, HTML och CSS så kan man bygga applicationer som körs i Spotifys desktopklient. Dessa appar kan spela musik, skapa playlists, komma åt info om artister etc. Några exempel på appar är en koppling till Last.fm för personaliserade musikrekommendationer och The Guardians app för att se tidningens musikrecensioner. Vill man komma igång och bygga egna appar så måste man ansöka om ett app developer konto.

För att börja testa apparna så måste man ladda ner en preview version av Spotifys klient. Det är väl värt det, apparna gör Spotify så mycket bättre och är ytterligare ett briljant steg framåt för musiktjänsten.

Twitters iOS ramverk

Sedan iOS 5 så är Twitter en del av operativsystemet (nästan i alla fall), men fram till denna vecka så har det inte gått för vem som helst att använda denna tajta Twitter-iOS integration. Nu har de släppt iOS Twitter framework som gör det möjligt för alla iPhone/iPad appar att använda Twitters single sign-on, personalisering mm. Detta kan vara väldigt användbart för alla iOS appar som har någon sorts integration med Twitter.

Twitter uppdaterar Search APIet

Twitter har gjort mindre uppdateringar av sitt Search API, men dessa mindre uppdateringar gör att APIet nu är mycket mer värdefullt för utvecklare. Tidigare så kunde man hitta tweets, men man kunde inte få veta ett enskilt tweets sammanhang. Nu returneras det om ett tweet är ett svar till ett annat tweet (via in_replay_to_status_id), vilket gör att man kan ta fram konversationer via sök-APIet.

Det var allt för denna vecka. För att inte missa några API-nyheter så stalka mig på Twitter (@andreaskrohn).

Domänsöks-API

Fredrik Berglund har skrivit ett inlägg på Loopias blogg om hur man bygger Sveriges snabbaste domänsök. En bieffekt av denna snabba domänsök är ett API som kan användas för att söka efter lediga domäner. Anropet http://doman.blynt.com/find.php?name=mashup&tlds=se,com,nu returnerar:

{
    status: "ok",
    se: "taken",
    com: "taken",
    nu: "free"
}

Tyvärr verkar inte allt vara 100% korrekt, mashup.nu ägs nämligen av undertecknad.

Readability länkförkortar-API

Readability är en tjänst som formaterar om webbsidor och gör den mer läsbar (dvs inga annonser och annat störande). De har givetvis ett API för sin formateringstjänst och nu har de också kommit med ett nytt länkforkortar-API på rdd.me.

Med detta API så förkortar man en länk precis som man kan göra med bit.ly eller to.ly. Skillnaden mellan rdd.me och dessa andra tjänster är att den sida den förkortade länken leder till blir snyggt formaterad via Readability.

Systemet API

Med Systemet API så kan man hämta data om Systembolagets sortiment och butiker. Det är en filtrerad, förbättrad och organiserad version av Systembolagets eget API. Jag skrev i mer detalj om detta i mitt tidigare inlägg – Systembolagets data och Systemet API – skål för öppen data.

Uppdatering av Google Calendar API

Google har uppdaterat sitt Calendar API till version 3. Bättre support för återkommande händelser, tillgång till det nya GUIt och händelsers färger och JSON support är några av nyheterna.

Google+ API för foto och bilder, men inte än

Under veckan som gått så publicerade Google ett blogginlägg om Google+ nya photo och video API, men det inlägget försvann rätt snabbt utan förklaring. Som tur är så han Google cacha sitt eget blogginlägg så att TechCrunch kunde skriva om det.

APIet, som antagligen kommer snart, skulle ge läsmöjligheter till publika bilder och videos som har publicerat på Google+. Visst är det bra att Google fortsätter att utöka Google+ APIet, men är det inte dags med ett skriv-API snart?

Det var allt för denna vecka. Som en liten teaser så kan jag säga att det är en ny version av mashup.se med både nytt utseende (tack Kemie Guaida) och en massa ny funktionalitet (tack Linus Bohman). Dessutom så kommer snart betatestandet av apiHQ igång. Mycket kul på gång!

Systemet API – hämta endast den data du vill ha

Med Systemet API så kan man hämta endast de produkter man är intresserad av, tex endast whisky eller endast vita viner som kostar max 80 kr. Man kan också hämta ut detaljerad information om en enskild produkt. Det är samma data som är tillgänglig direkt via Systembolagets filer men organiserad på ett mer lättanvändbart sätt.

Vill man hämta ut alla produkter som kostar max 10 kr (fint ska det va!), med en max volym på 33cl och sortera på billigast pris så ser anropet ut så här:

http://systemetapi.se/product.json?max_price=10&max_volume=0.33&order_by=price&order=ASC

Tillbaka får man JSON, tex:

    {
        article_id: "338516",
        name: "San Miguel",
        name_2: "0,0%",
        price: "9",
        volume: "0.25",
        price_per_liter: "36",
        type: "Alkoholfritt, Öl",
        packaging: "",
        closure: "",
        origin: "Spanien",
        origin_country: "Spanien",
        producer: "San Miguel",
        year: "0",
        alcohol: "0",
        alcohol_percent: "0%",
        apk: "0",
        ecological: "0",
        koscher: "0"
    }

Från exporterade filer till användbart API

APIet är skrivet av Karl Roos på Vimea med hjälp av PHP, MySQL och hans egenutvecklade ramverk Solidocs. Det började med att en av Karls kollegor ville bygga en APK-app (milliliter alkohol per krona) och behövde en backend, resultatet är ett API som vi alla kan använda. I framtiden så kommer han att lägga till butiksinformation, förbättra filtrerings och sorteringsalternativen samt att lägga till historik på prisförändringar.

Själv tycker jag att det är bra jobbat av Karl att ta intressant data, organisera den och göra den tillgänglig på ett mer användbart sätt. Det vinner alla på, inklusive Systembolaget som får ett bra API utan att behöva investera tid och resurser på det. Förhoppningvis så kommer inte Systembolaget att reagera negativt på Karls jobb. Han har försökt får ett svar från dem om man får utveckla ett API ovanpå deras filer, men han har ännu inte fått något konkret svar.

Priser från 46elks

Med 46elks API så kan man ta emot och skicka SMS samt koppla vidare röstsamtal (läs mer om 46elks SMS API i ett av mina tidigare inlägg). Tidigare har 46elks tjänster varit gratis eftersom de ha varit i alpha, men nu har de börjat ta betalt. Priserna är rimliga, 35 öre/SMS, 79 öre/min för ett samtal och 9 kr/mån för ett telefonnummer (det krävs ett speciellt nummer för att kunna använda APIet).

Zypr – nästan som Siri men med ett öppet API

Apples HAL-liknande röststyrning Siri är ju trevligt, men ännu finns inget API som gör det möjligt för utvecklare att använda Siri för sina egna appar. Ett alternativ är Zypr från Pioneer. Där kopplas tjänster från Amazon, Google, Twitter och många andra ihop med röststyrning och ett gemensamt API. Bygg alltså in smart röststyrning i dina egna appar. Än verkar det vara engelska som gäller och många av de integrerade tjänsterna är inte så stora i Sverige, men det är i alla fall en intressant tjänst.

Guldmobil till Trafiklab

Trafiklab har vunnit en Guldmobil som årets offentliga mobila tjänst, priset delas ut av tidningen Mobil. Motivationen är “för att ha drivit ett unikt initiativ inom öppen data och satt en ny standard för hur kollektiv information kan användas och berikas.”. Trevligt att Trafiklab och offentliga APIer belönas, tack till Mobil från mig, Samtrafiken, Deportivo, Kollegorna och alla andra som har jobbat hårt med Trafiklab!

Googles OAuth 2.0 Playground

I förra veckans API måndag nämnde jag Twitters OAuth Tool som gör det lättare att testa sin egen OAuth implementation. Google vill inte vara sämre och har nu kommit ut med OAuth 2.0 Playground där man kan testa hur OAuth 2.0 funkar för olika Google APIer.

Det var allt för denna vecka. Vill du ha fler API-nyheter och API-tips hela veckan lång så följ mig (@andreaskrohn) på Twitter.

Cash Rules Everything Around Me

Vi börjar med ett praktiskt API för att värma upp, nämligen Open Exchange Rates som ger tillgång till växelkurser mellan nästan alla världens valutor. Det finns också ett bra javascriptbibliotek, money.js om man vill använda växelkurserna direkt i Javascript.

Ett annat pengarelaterat API är Handelsbankens inofficiella API som Björn Sållarp har dokumenterat genom att sniffa trafiken till och från Handelsbankens iPhoneapp. Med APIet kan man lista konton, lista kreditkort, föra över pengar mellan konton etc.

När man har all information om sitt bankkonto och om växelkurser så vill man ju visa dem i fina diagram, och där är Google Charts API mycket användbart. Med det kan man göra snygga pajdiagram, stapeldiagram och alla andra typer av diagram bara genom lite javascript.

Med APIer kommer man åt allt

Google har väldigt många APIer och de har alla en massa metoder och parametrar. Som tur är så finns Google APIs Discovery Service vilket är ett API för att få reda på information om ett 20-tal av Googles APIer. Väldigt meta.

Räcker inte alla Googles APIer så kan man bygga ett eget mot vilken webbsida som helst med Diffbot. De använder “visuella algoritmer” för att analysera en webbsida och automatiskt returnera den information som är mest intressant. Ett perfekt sätt att bygga RSS-feeds för sidor som inte har det eller att få veta när en webbsida har uppdaterats.

Behöver man information från email istället så kan man använda Context.io som ger ett API mot ett mailkonto. Perfekt för att ta fram alla konversationer med en given kontakt i ett CRM-system eller att komma åt bifogade filer.

Ibland har man bara en emailadress, men man vill veta mycket mer om personen bakom emailadressen. Då kan man använda Fullcontact APIet där man skickar in en emailadress och får tillbaka information som namn, ålder, kön, profilbilder etc som har samlats ihop från olika tjänster på nätet. Perfekt för att få mer information om sina kunder.

APIer för designers

Att koppla en emailadress till ett namn kan vara användbart, men ibland behöver man 100-tals namn för tester eller för att populera designmockups med realistisk data. Med NamnAPI så kan man generera svenska mans- och kvinnonamn slumpvis. Enkelt och användbart.

Behöver man längre texter för sina mockups så är Loripsum APIet ett bra val. Med det APIet så kan man generera “Lorem ispum…” texter i olika längd och formaterat på alla möjliga olika sätt. Behöver man dessutom bilder för sina mockups så kan man få det via Flickholdr som returnerar bilder från Flickr. Ange bara vilken tag bilden ska ha, tex “sunrise” eller “stockholm”, och vilken storlek den ska ha och tillbaka får man en bild. Aldrig mer behöver mockups ha gråa tråkiga exempelbilder.

Storebror vet vem du är

Med Flickholdr kan man få fram slumpvisa bilder, men tänk om du har en bild på en person och vill veta vem det är. Då är APIet från Face.com vad du letar efter. Börja med att ladda upp en stor mängd personbilder med tillhörande namn, tex alla dina Facebookvänner. Skicka sedan upp en ny bild på en person och du får tillbaka ett namn. Både lite skrämmande och otroligt coolt samtidigt.

När du väl har namnet på personen så kan du hitta hans telefonnummer via APIet från 118100. Skicka in ett namn och få tillbaka adress och telefonnummer, eller skicka in ett nummer och få tillbaka ett namn.

Telefontjänster

När du väl har en persons telefonnummer så kan du skicka honom ett SMS via 46elks. Med deras API kan du också ta emot SMS och koppla röstsamtal. Har du ett telefonnummer så kan man ta reda på vilken operatör (Telenor, 3, Telia etc) som numret tillhör via Post- och Telestyrelsens API. PTS fick många frågor om vilken operatör som hade hand om ett visst nummer, men genom att publicera ett API så kan de spara pengar på support.

Från punkt A till punkt B

Ibland vill man inte ringa eller SMS folk, utan faktiskt göra något så gammaldags som att skicka ett paket. Det kan ju kosta en hel del pengar och det finns många tjänster att välja bland. Fraktjakts API hjälper till att hitta det billigaste alternativet och där kan man dessutom beställa transporttjänsterna direkt via APIet.

Vill man flytta sig själv istället för ett paket så kan man använda ytterligare ett inofficiellt API. Precis som Handelsbankes så har SJ en iPhoneapp och precis som för Handelsbanken så blev SJs app-API dokumenterat och publicerat. Tack vare Erik Pettersson så finns det nu bra dokumentation för SJs API för tidtabeller, stationer och annan tåginformation.

Är” SOAP” en svordom?

Tänker man SJ tänker man lätt på svordomar, och är man som jag så tänker man direkt på ett svordoms-API. I Googles What Do You Love tjänst så vill de undvika fula ord, och de skapade därmed ett API där man kan skicka in ett engelskt ord och få tillbaka True eller False om det är en svordom eller inte. Google dokumenterade inte detta API, men det går inte att gömma någonting så det finns bra dokumentation i alla fall.

Googles svordoms-API funkar som sagt bara för engelska ord och jag har inte hittat någon svensk motsvarighet, men Libris har ett väldigt användbart svenskt stavnings-API. Stavninsförslagen baseras på dels innehållet i bibliotekssystemet Libris och dels på sökningar som användare har gjort i systemet.

Offentlig data + UFOs?

Informationen i Libris är ju nästan offentlig information och det finns många andra exempel på hur offentlig data finns tillgänglig via API (jag vet att denna övergång är lite långsökt, försök att förlåta mig). Ett mycket bra exempel är Openaid som är ett samarbete mellan SIDA och UD och ger tillgång till biståndsdata. Vill du veta vilka bevattningsprojekt i Kenya som Sverige gav bistånd till 1997 så är det bara att använda Openaids API och söka upp informationen.

Det skulle vara mycket intressant om någon kunde samköra Openaid APIet med UFO Sightings APIet som gör det möjligt att söka bland rapporterade UFOs välden runt. Finns det något sammanhang mellan vad Sverige har gett bistånd till och var det syns flygande tefat? Har starka misstankar på att det finns en konspiration dold här någonstans!

Vill du att jag ska komma och presentera möjligheterna med APIer, affärsstrategier eller hur man kommer igång? Skicka ett mail till andreas@dopter.se eller ring mig på 0709-780794.

Arbetsförmedlingens API

Med Arbetsförmedlingens nya API så kan man hämta ut platsannonser från platsbanken. Det går att söka efter annonser baserat på län, kommun, yrke samt fritext. Dessutom så kan man hämta ut information om alla landets arbetsförmedlingar, som tex öppettider och telefonnummer.

I februari så var jag, Peter Krantz och Ted Valentin inbjudna till en workshop hos Arbetsförmedlingen för att snacka om det API de utvecklade. Det är kul att se att det blev ett bra API i slutändan och jag hoppas att många kommer att använda APIet istället för som tidigare skrapa platsbankens sajt.

118100 API

Tidigare har jag nämnt Eniros API där man kan söka efter företagsinfo och där man kunde söka efter information om privatpersoner. Efter bara några dagar så tog Eniro bort möjligheten att söka efter privatpersoner pga avtalsproblem (vad det nu betyder). Som tur är så har inte Eniro monopol och 118100 har nu ett API där man just kan söka på privatpersoner. 118100 kallar sitt nuvarande API ett “första lilla provskott” och lovar att mer kommer, och det låter ju lovande!

Tack Jonas Lejon för tipsen om 118100 APIet och Arbetsförmedlingen. Om ni har några tips om nya svenska APIer så hör gärna av er via andreas@dopter.se eller @andreaskrohn.

Bygg appar för EMIs artister

EMI och The Echo Nest har gjort det möjligt för vem som helst att bygga appar för EMIs artister. Dessa appar har tillgång till musik, videos och information om sånger och artister. Av EMI godkända appar säljs och utvecklaren för 40% av nettoinkomsten, resten går till att betala för musikrättigheter etc. Ett fantastiskt bra initiativ av EMI och något som alla andra musikbolag (och TV/film-bolag för den delen) bör ta efter. Alla utvecklare med musikintresse bör ta en seriös titt på vad man kan göra med denna lösning!

Twitter förenklar för OAuthanvändare

Att implementera OAuth kan vara frustrerande, ett litet fel någonstans så funkar ingenting och det kan vara svårt att hitta felet. Nu är det lite lättare att implementera OAuthlösningar mot Twitter med deras nya OAuth tool. Med det verktyget så kan man generera OAuthsignaturer för ett givet Twitter API anrop och på så sätt jämföra med vad ens egen kod genererar. De har också förbättrat dokumentationen runt OAuth, vilket inte var en dag för sent.

Inofficiella APIer från Handelsbanken och Länsförsäkringar

Precis som SJ, Trafikverket och många andra tidigare fått erfara så kommer inofficiella APIer att dokumenteras för eller senare. Nu är det Handelsbanken och Länsförsäkringar Bank som har råkat ut för samma sak tack vara Björn Sållarp. Han har tidigare utvecklat Mitt Saldo – en iPhone app för Swedbank, SEB, Nordea och Handelsbanken mfl som mrf screen scraping gör det möjligt att hålla reda på sitt saldo på banken.

Nu har Björn publicerat ett API till Länsförsäkringar Bank som gör det möjligt att lista konton, föra även pengar mellan konton, lista kredit kort mm. Han har också publicerat ett API till Handelsbanken där man kan göra samma saker plus att man kan få fram ränteinformation och lista bankkontor. Förhoppningsvis kommer detta att få bankerna att inse vilken oerhörd potential det finns i APIer och publicera sina APIer själva.

Tack Björn för allt ditt jobb, du är en svensk API-hjälte!

Google Maps APIet inte längre gratis

Någon gång i början av 2012 (exakt datum ej fastställt) så kommer Google att börja ta betalt för användningen av Google Maps APIet, men bara från dem som har rätt mycket trafik. För att behöva betala så krävs mer än 25.000 visade kartor per dygn eller 2.500 “styled maps” per dygn (en “styled map” är en karta med speciell färgskala etc). Begränsningen är per API – det går alltså att ha 25.000 kartor/dygn visade för vart och ett av de tre Maps APIerna (JS Maps, Static Maps och Street View Images) innan man måste betala. Om man når den magiska gränsen så kostar det 4USD/1000 extra kartvisningar och det betalar man via Google API Console. Har man väldigt många kartvisningar så finns det även Maps API Premier som då är något mer kostnadseffektivt.

Just nu finns det inget som användare av Google Maps APIet att göra förutom att hålla ett öga på Google Geo Developers Blog. Där kommer de att meddela 30 dagar i förväg när de kommer att börja ta betalt. I slutändan så kommer de flesta inte att behöva betala någonting, 25.000 visningar/dygn gör det fortfarande möjligt att leka med Google Maps APIet utan risk för konkurs. Tycker man att det är för dyrt så finns det gott om alternativ tex Bing Maps, OpenStreetMaps och Mapbox (tack Pelle Wessman för tipset om Mapbox).

Detta är en stor förändring i API branchen. Google Maps är ett av de mest använda APIerna i världen och har varit inkörsport för de flesta som idag jobbar med APIer. Att Google nu börjar ta betalt betyder att APIer nu är en affärsverksamhet och signalen som Google sänder till andra som publicerar APIer är tydlig – kan inte APIet bära sig själv så är det inget bra API. Personligen tror jag att det kommer att betyda att fler APIer kommer att börja kosta, och andra sidan så betyder det att chansen för att dessa APIer överlever är mycket större och därmed något man faktiskt kan bygga en framtida business på.

Flattr API v2

Flattr har släppt en beta av version 2 av sitt API. De stora förändringarna är att XML nu har fått sällskap av JSON och JSONP samt att det är OAuth 2 som gäller för autentisering.