User Tools

Site Tools


api

This is an old revision of the document!


API

API (Application Programming Interface) är en överenskommet sätt att kommunicera mellan datorprogram som möjliggör för ett program att ställa frågor och få svar från ett annat. Någon som har en stor databas kan exempelvis skapa ett API så att andras program (via exempelvis Internet) kan göra sökningar och begära ut uppgifter från databasen utan att programmet som begär data får direkttillgång till databasen.

Exempel på befintliga API:n

Här ges några exempel på API:n för att ge en inblick i vad det handlar om och hur det går till.

LIBRIS - Xsearch

Databaskatalogen [http://libris.kb.se/|LIBRIS] (de svenska forskningsbibliotekens gemensamma katalog) har ett “lättvikts-API” där frågor (sökningar) ställs via HTTP-anrop (samma sorts anrop som används för att anropa hemsidor genom webbläsares adressfält).

Funktionen kallas Xsearch och för att exempelvis söka efter boken med titeln Fårad mark formuleras frågan alltså på samma sätt som en hemsideadress:

[http://libris.kb.se/xsearch?query=TIT:Fårad+mark]

Om du klickar på länken ovan ges svaret på formatet [XML]. Tanken med XML-formatet är att det skall kunna läsas framförallt av olika datorprogram men även vara förståeligt för människor. Det går också att få svaret på annat format, exempelvis [http://www.json.org/|JSON (JavaScript Object Notation)], vilket också kan förstås av olika datorprogram men är snäppet mer lättförstått för människor. Svar på detta format ges genom att lägga till &format=json i slutet av HTTP-anropet:

[http://libris.kb.se/xsearch?query=TIT:Fårad+mark&format=json]

Svaret som ges denna gång ser ut som följer:

@@{“xsearch”: { “from”: 1, “to”: 1, “records”: 1, “list”: [ { “identifier”: “http://libris.kb.se/bib/8231645”, “title”: “Fårad mark : handbok för tolkning av historiska kartor och landskap”, “creator”: “Cserhalmi, Niklas, 1968-”, “type”: “text”, “publisher”: “Stockholm : Sveriges hembygdsförb”, “date”: “1998”, “language”: “swe”, “description”: “Recensionslänk” } ] }}@@

Observera att båda dessa svar kan läsas av ett program skrivet med programmeringsspråket [Python].

Information om hur frågor till LIBRIS formuleras ges [http://librishelp.libris.kb.se/help/xsearch_swe.jsp?open=tech|här].

Google Maps - Google Static Maps API

Det finns flera olika API:n kopplade till [Google Maps] (en överblick finns [http://code.google.com/intl/sv-SE/apis/maps/index.html|här]. Ett API värt att nämna heter Google Static Maps API. Den möjliggör att en begäran skickas i form av ett HTTP-anrop och får då en [Karta|statisk kartbild] som svar.

Exempelvis ger HTTP-anropet nedan den nedanstående kartbilden över universitet som svar. I anropet har plats och [Skala|skala] valts, en markör placerats ut vilken pekar ut Y-huset. Vidare har färger gjorts mörkare samt ändrats för vattnet och vägarnas kanter. Mer om hur API:n fungerar kan läsas [http://code.google.com/intl/sv-SE/apis/maps/documentation/staticmaps/|här].

@@http://maps.google.com/maps/api/staticmap?center=Stockholms+universitet,Stockholm&zoom=15&size=512x512&maptype=roadmap&markers=color:green|label:Y|59.365597,18.056416&style=feature:landscape|element:geometry|lightness:-50&style=feature:water|element:geometry|hue:9BB2CE&style=feature:road.local|element:geometry|hue:D95E00&sensor=false@@

:[image||{UP}/staticmap.png]

api.1459329918.txt.gz · Last modified: 2016/03/30 11:25 (external edit)