API

Dokumentation av biljett.coms webbflöde

Biljett.com tillhandahåller ett webbflöde för andra webbplatser och applikationer som vill publicera information om event och biljetter.

Adress till flödet: http://www.biljett.com/event/feed/RSS/v1

Flödet följer specifikationen för RSS 2.0 [http://cyber.law.harvard.edu/rss/rss.html], och bygger ut detta med ett eget namespace för event- och biljettinformation.

Flödets innehåll

Flödet innehåller kommande, publika eventtillfällena, sorterade i stigande tidsordning.

Licens och tillåten användning

Innehållet i flödet får användas i enlighet med licensen http://creativecommons.org/licenses/by/2.5/se/.

Flödet bör inte hämtas från Biljett.com oftare än en gång per timme. Vid missbruk kan IP-adresser stängas av från flödet.

Versionshantering

Flödets ovanstående webbadress anger att webbservern ska generera ett RSS-flöde med version 1 av strukturen som dokumenteras här.

Om strukturen i framtiden förändras på ett sätt som ej är bakåtkompatibelt, kommer webbadressen att ändras, exempelvis till http://www.biljett.com/event/feed/RSS/v2. Tidigare publicerade webbadresser kommer fortsätta att gälla och returnera samma format och struktur som tidigare.

Det egna namespace med element för event- och biljettinformation kan utökas med nya element och attribut utan att versionsnumreringen förändras. Detta namespace deklareras i rss-elementet med en webbadress som innehåller ett versionsnummer:

xmlns:e=”http://biljett.com/xmlns/events/v1/”

Om strängen ändras har namespace uppdaterats. Detta bör inte orsaka ett fel i inläsaren, men bör generera ett meddelande om att utöka inläsaren med nya element eller attribut.

Förklaring av event, biljettyper och eventtillfällen

Event på Biljett.com kan ha flera biljettyper. Biljettyperna kan ha olika priser och tidpunkter. (Exempel på biljettyper kan vara studentbiljetter och ordinarie pris, samt föreställningar som ges flera gånger vid olika tillfällen.)

Varje tillfälle då ett event infaller kallas i denna dokumentation för ett eventtillfälle. Denna indelning av event är helt syntetisk och finns inte lagrad någonstans, utan härleds från event och biljettyper.

Arrangören kan när som helst redigera, radera eller lägga till biljettyper.

Element som ingår i flödet

channel

De element som kan förekomma i <channel> är:

• title
• link
• description
• language
• cc:license
• lastBuildDate
• item

channel > cc:license

Elementet <cc:license> innehåller en länk till den licens som gäller för innehållet i flödet.

channel > item

Varje <item> innehåller information om ett särskilt eventtillfälle. Samma event kan alltså delas upp på flera <item> om det finns biljettyper med olika tidpunkter.

De element som kan förekomma i en <item> är:

• title
• link
• guid
• description
• category
• enclosure
• e:startdate
• e:location
• e:tickets

De flesta behöver ingen ytterligare dokumentation utöver den för RSS, men några element förklaras i detalj nedan.

channel > item > link

Elementet <link> innehåller webbadressen till eventets sida på Biljett.com. Denna webbadress identifierar eventet, men kan ändras av arrangören när som helst.

channel > item > guid

Elementet <guid> innehåller ett unikt id för detta eventtillfälle. Eftersom eventtillfälle härleds och inte lagras på Biljett.com, skapas ett id baserat på eventets interna id och biljettypens datum och tid. <guid> ändras alltså om arrangören ändrar tidpunkt för biljettypen.

channel > item > enclosure

Elementet <enclosure> innehåller en länk till den logotyp som arrangören har laddat upp.

channel > item > e:id

Elementet <e:id> innehåller eventets interna id, som aldrig förändras under eventets livslängd. Observera att detta inte unikt identifierar en <item>, eftersom samma event kan delas upp i flera <item> (se ovan).

channel > item > e:startdate

Elementet <e:startdate> innehåller tidpunkt då eventtillfället startar. Formatet följer ISO 8601, exempelvis ”2010-02-12T15:19:21+02:00”.

channel > item > e:location

Elementet <e:location> innehåller flera element med information om var eventet äger rum. Informationen kommer från Google Geocoding API.

channel > item > e:tickets

Elementet <e:tickets> förekommer en gång för varje biljettyp, och innehåller flera element med information om de biljetter som är till försäljning. Sorteringsordningen för biljetterna är odefinierad.

3 Responses

1. Nya funktioner på biljett.com | Biljettbloggen skriver:

   november 12, 2010 kl. 1:24 e m

   [...] En väldigt trevlig nyhet är att vi nu kan erbjuda ett API med alla publika evenemang. Det är ett öppet RSS-flöde där vem som helst kan hämta en lista över kommande publika evenemang. RSS-flödet inkluderar bla datum, tid, adress, kartkoordinater, beskrivning och biljettpriser. Här kan ni läsa mer om vårt API. [...]
2. API för evenemang från Biljett.com « Mashup.se skriver:

   april 14, 2011 kl. 11:37 f m

   [...] som marknadsföring Via Biljett.coms API så kan man hämta ner alla evenemang för att sedan presentera dem i sin egen lösning, något [...]
3. 20+ svenska API:er – Hela listan | jenst.se skriver:

   juni 28, 2011 kl. 6:52 f m

   [...] biljett.com API [...]