Folketsting Blog

Så har Folkets Ting fået et API! Yay. API’et er noget jeg har lovet siden Offentlige Data i Spil Konferencen i februar 2010, og jeg er glad for endelig at have Folkets Ting-delen færdigt.

Teknisk er der tale om en service der leverer data efter OData protokollen. Det er noget Microsoft står for, men der findes client-libraries til de fleste programmeringssprog. Der er endda et Excel-plugin der kan trække data fra en OData service. Services kan levere både XML og JSON, så det er muligt at lave rene browser-mashups. API’et kan sende metadata om det data der eksponeres (se f.eks. XML der kommer ud her: http://folketsting.dk/data/Service.svc/$metadata), så det er i et vist omfang selv-dokumenterende. Hvis der er noget du er i tvivl om, er du meget velkommen til at skrive til friism+ftapi@gmail.com.

Opdatering: Jeg har skrevet en  blog-post med flere eksempler på brug af API’et.

Jeg har lavet en Google Maps mashup der giver dig mulighed for at udforske de ti mest rejsende Folketingspolitikeres rejser. De to relevante API-kald ser sådan her ud:

http://folketsting.dk/data/Service.svc/Politician/?$expand=CommitteeTripParticipant&$select=Firstname,Lastname,PoliticianId,CommitteeTripParticipant/CommitteeTripId&$format=json&$callback=render&callback=render&apikey=[APIKEY]

http://folketsting.dk/data/Service.svc/CommitteeTrip/?$expand=CommitteeTripParticipant,CommitteeTripDestination&$select=Purpose,ActualExpenses,Budget,NonPolParticipants,CommitteeTripId,Place,CommitteeTripParticipant/CommitteeTripParticipantId,CommitteeTripDestination/Lat,CommitteeTripDestination/Lng,CommitteeTripDestination/PlaceNameName&$format=json&$callback=callback1&callback=callback1&apikey=[APIKEY]

Det første kald henter alle politikere samt information om hvilke rejser de har været med på. Det andet kald henter alle udvalgsrejser inkl. udgifter og destinationer. Informationerne bliver kombineret og lagt på kort. Du kan se resultatet her og bede din browser vise dig kildekode.

Læg mærke til at kald til API’et kræver en API-key. Keys kan genereres frit og gratis på Folkets Ting, og der er ingen begrænsninger i brug af API’et. Nøglen giver dog Folkets Ting mulighed for midlertidigt at lukke for adgang for brugere der laver mere API-trafik end vi kan håndtere.

Det data som API’et publicerer kommer (hovedsageligt) fra Folketingets hjemmeside på ft.dk. Det fremgår af deres side om copyright at de fleste af teksterne ikke er genstand for ophavsret. Dog er vi i tvivl om status af f.eks. tale-referater. Folkets Ting kan ikke rigtig hjælpe med jura, du bliver nød til selv at kontakte Folketinget for at høre om den brug af data du påtænker er OK. I parentes bemærket, har vi aldrig spurgt om lov til at lave Folkets Ting websitet, og Folketinget har aldrig brokket sig.

Hvis du bruger data fra Folkets Ting er du meget velkommen til at nævne os eller give os et link, men det er ikke et krav.

Som bekendt vandt Folkets Ting kr. 100.000 til brug for udviklingen af API’er. Vi har ikke brugt nogen af pengene endnu, men vi forventer snarest at bruge nogen af dem på at udskrive en lille konkurrence om hvem der bedst kan genbruge de nye data på snedige måder.

Til #ODIS konferencen lovede jeg også adgang til kommunal og regional data svarende til hvad Folkets Ting disponerer over. Det projekt er jeg slet ikke gået i gang med endnu, så I må, indtil videre, stille jeg tilfredse med hvad der kommer ud af Folketinget.

Jeg glæder mig utrolig meget til at se hvad I kan få ud af API’et!