API

Vi öppnar upp vårt data via ett så kallat Application Programming Interface (API). API:t är av typen REST och du anropar metoder genom HTTP. API:t är fritt att använda så länge mängden trafik du genererar är inom rimliga gränser. Använd cache! Om du har speciella behov ser vi gärna att du tar kontakt med oss innan du sätter igång.

Metod: Program

URL

http://www.tempofestival.se/api/program/

Format

XML, JSONP

Parametrar

festival (Id – Required)
Vilken festival vill du hämta programpunkter för? Använd metoden Festivals för att identifiera tillgängliga festivaler och dess id:n.

type (Id – Optional)
Vilken typ av programpunkt vill du hämta (film, radio etc)? Använd metoden Types för att identifiera tillgängliga typer och dess id:n. Anges ingen typ returneras alla typer av programpunkter.

format (String – Optional)
Vilket format vill du ha svaret i? Ange json eller xml, anges inget skickas XML.

callback (String – Required for JSONP)
Funktionsnamn för JSONP-wrappern. Många js-bibliotek hanterar detta åt dig automatiskt.

Exempel

http://www.tempofestival.se/api/program/?festival=1&type=2
http://www.tempofestival.se/api/program/?festival=1&format=json&callback=?

Smakprov XML

<tempo status="ok">
    <program_item>
        <id>237</id>
        <type>Film</type>
        <title>Fina filmen</title>
        <photo>http://tempofestival.se/files/program/295.jpg</photo>
        <info>Short info</info>
        <description>HTML formatted description</description>
        <url>http://tempo.martin/program/#fina-filmen</url>
        <video>Video embed code</video>
        <schedule>
            <slot>
                <start>2009-03-07T17:45</start>
                <end>2009-03-07T19:00</end>
                <location>Victoria 3</location>
                <shown_with>The Leftovers, The Penalty Box</shown_with>
            </slot>
            ...
        </schedule>
    </program_item>
    ...
</tempo>

Smakprov JSONP

jsonp123([
    {
        "id": "237",
        "type": "Film"
        "title": "69",
        "photo": "http://tempofestival.se/files/program/295.jpg",
        "info": "Short info",
        "description": "HTML formatted description",
        "url": "http://tempo.martin/program/#fina-filmen",
        "video": "Video embed code",
        "schedule": [
            {
                "start": "2009-03-06T20:A30",
                "start": "2009-03-06T21:40",
                "location": "Victoria 1",
                "shown_with": "The Leftovers, The Penalty Box"
            },
            { ... }
        ]
    },
    { ... }
]);

Metod: Festivals

URL

http://www.tempofestival.se/api/festivals/

Format

XML, JSONP

Parametrar

format (String – Optional)
Vilket format vill du ha svaret i? Ange json eller xml, anges inget skickas XML.

callback (String – Required for JSONP)
Funktionsnamn för JSONP-wrappern. Många js-bibliotek hanterar detta åt dig automatiskt.

Exempel

http://www.tempofestival.se/api/festivals/
http://www.tempofestival.se/api/festivals/?format=json&callback=?

Smakprov XML

<tempo status="ok">
    <festival>
        <id>1</id>
        <title>Tempo 2009</title>
    </festival>
    ...
</tempo>

Smakprov JSONP

jsonp123([
    {
        "id": "1",
        "title": "Tempo+2009"
    },
    { ... }
]);

Metod: Types

URL

http://www.tempofestival.se/api/types/

Format

XML, JSONP

Parametrar

format (String – Optional)
Vilket format vill du ha svaret i? Ange json eller xml, anges inget skickas XML.

callback (String – Required for JSONP)
Funktionsnamn för JSONP-wrappern. Många js-bibliotek hanterar detta åt dig automatiskt.

Exempel

http://www.tempofestival.se/api/types/
http://www.tempofestival.se/api/types/?format=json&callback=?

Smakprov XML

Smakprov JSONP

jsonp123([
    {
        "id": "15",
        "title": "Film"
    },
    { ... }
]);