Innledning

NATT&DAG tilbyr en enkel tjeneste for å hente ut informasjon om arrangementer fra vår «Hva skjer?»-kalender. Det er mulig å hente ut informasjon om kommende arrangementer filtert på by og type arrangement.

Tilgang til tjenesten er begrenset, og krever at du får tildelt en API-nøkkel fra oss. Send e-post til support@nattogdag.no med informasjon om hvordan du ønsker å bruke tjenesten.

Standardvilkår for bruk av tjenesten

NATT&DAG tilbyr denne tjenesten vederlagsfritt. Imidlertid krever vi følgende for bruk av tjenesten:

  1. Om informasjon fra vår database brukes i en liste over arrangementer, skal det i tilknytning til listen gjøres klart at tjenesten er levert av NATT&DAG og det skal linkes tilbake www.nattogdag.no. F. eks.: Arrangementskalender levert av NATT&DAG.
  2. Om informasjon fra vår database brukes til å vise enkeltarrangementer skal det på hver arrangementsside linkes tilbake til NATT&DAGs egen side for dette arrangementet slik denne er oppgitt i XML-filen (event_url).
  3. Unngå unødig mange kall til tjenesten. Informasjon bør mellomlagres i deres systemer.

Teknisk informasjon

Spørringer mot vår database gjøres ved å sende en GET-request til følgende URL:
http://www.nattogdag.no/services/events/list.<FORMAT>?api_key=<API_KEY>&type=<TYPE>&limit=<LIMIT>

FORMAT er ønsket format, enten xml eller json.
API_KEY får du ved å kontakte oss på support@nattogdag.no.
TYPE kan utelates. Lovlige verdier er konsert, klubb, fest, teater, filmvisning, utstilling og bokkveld.
LIMIT kan utelates. Angir maks antall arrangementer. 20 er standardvalg om denne ikke oppgis.

Responsen fra vårt system er en XML- eller JSON-fil basert på upcoming.org sitt format, men noe forenklet:


  <?xml version="1.0" encoding="UTF-8"?>
  <rsp stat="ok" version="1.0">
    <event id="260" name="Deathjazz pres: ZANUSSI 5" 
    event_url="http://www.nattogdag.no/hvaskjer/konserter/081104-deathjazz-pres-zanussi-5"
    event_type="Konsert"
    description="Ekstrovert og surrealistisk miks av groove, energisk frijazz og vakre melodier" 
    start_date="2008-11-04" 
    start_time="21:30:00"
    date_posted="2008-10-28 12:54:00" 
    venue_name="Mono"
    venue_address="Pløensgate 4"
    venue_city="Oslo"
    venue_country_name="Norge"
    venue_country_code="no"
    venue_url="http://www.cafemono.no/"
    venue_phone="22414166"
    photo_url="http://www.nattogdag.no/uploads/event/081104-deathjazz-pres-zanussi-5.jpg"
    ticket_price="100,-"
    />
  </rsp>

Ved eventuelle feil vil det bli returnert en forklarende feilmelding.