Townbase API

Det lokale innholds-API-et som forvandler byguider til byinfrastruktur – fra én innholdskilde til hver skjerm i byen

Kontakt oss for å komme i gang
Vector illustration of three stylized people standing together, wearing casual clothing in orange, white, and black.

Townbase API for utviklere

Alt du trenger for å bygge en lokal oppdagelsesopplevelse – i ett enkelt API

  • Hopp over skraping og datarensing. Få strukturerte, kuraterte oppføringer for arrangementer, steder og aktiviteter – klare til å koble inn i produktet ditt.

  • Bruk kategorier, tagger, områder og målgrupper fra våre site-endepunkter slik at grensesnittet ditt oppdaterer seg selv når innholdet vokser.

  • Hent arrangementskataloger fra ledende plattformer, velg strømmene du vil ha og hold guiden din full av ting å gjøre.

  • Match ditt design, domene og tone. Bruk Townbase som innholds- og infrastrukturmotor mens du bygger frontenden akkurat slik du vil ha den.

  • Bruk targets og rike filtre for å vise riktige arrangementer til riktige folk. Følg bruk og engasjement via dashboards og ukentlige rapporter.

  • Velg hvilket innhold API-et eksponerer, hvilke partnere som får nøkler og hvordan dataene brukes kommersielt på tvers av byer og publikasjoner.

  • Flerspråklig direkte fra start.

  • Bruk samme integrasjon for apper, kiosker, digital skilting, AI-assistenter, hotellverktøy og kalenderwidgets.

Illustration of a mobile phone displaying a fitness app with a person performing a pull-up, surrounded by trees.
A smartphone displaying a user interface with orange and gray notification banners and a central highlighted section.

Townbase API for kommuner, DMO-er og medier

Innholdet ditt blir infrastruktur. Publiser én gang, driv alt

  • 1

    Bygg én gang, bruk overalt. Én integrasjon per host er nok. Bruk samme API-nøkkel for apper, kiosker, digital skilting, hotellsystemer, kalenderwidgets og AI-assistenter.

  • 2

    La taksonomi og site-endepunkter gjøre jobben. Når arrangører og partnere oppdaterer innhold, følger kategorier, områder og målgrupper etter i alle grensesnitt.

  • 3

    Innebygd målgruppestyring. Bruk /targets og rike filtre for å vise riktige arrangementer til riktige personer og følge engasjement via dashboards og ukentlige øyeblikksbilder.

  • 4

    Flerspråklig fra dag én. Utnytt språkvarianter og språkendepunkter for å levere lokalt innhold til både innbyggere og besøkende, inkludert internasjonale turisme-apper.

  • 5

    Full kontroll for byer og medier. Publiser én gang og eie strømmen. Du styrer hvilke objekter som eksponeres, hvilke partnere som får nøkler og hvordan innholdet ditt brukes kommersielt.

Slik fungerer det — tre enkle steg

Ett API for alt lokalt innhold du trenger – arrangementer, steder, taksonomier og målgrupper – klart til å kobles inn i apper, nettsteder, skjermer og AI-assistenter.

A man in a white shirt stands writing on a digital interface with three floating window screens behind him.

1. Konfigurer ditt administrasjonsgrensesnitt

Teamet vårt konfigurerer alt, innholdsteamet ditt er klart til å begynne.

Vector illustration of three people communicating with icons for messages, likes, and smiles connected by lines.

2. Publiser og inviter partnere

Teamet ditt publiserer direkte. Inviter partnerorganisasjoner — arenaer, bedrifter, foreninger — til å sende inn og administrere sitt eget innhold. Alt samles i én aggregert, moderert strøm.

A woman stands looking at a text document with highlighted notes and arrows pointing to key information.

3. Send til din nettside på din måte

Full programmerbar kontroll for tilpassede integrasjoner i Sitevision eller andre systemer. Få en API-nøkkel via kontrakt, gjør enkle HTTP-kall for strukturert sanntidsdata. Bygg eget grensesnitt med total merkevaretilpasning, filtrer på kategorier/tagger/målgrupper, og bruk samme integrasjon for apper, widgets eller dashboards.

Townbase kommuner og destinasjoner

Vi tilbyr innholdskataloger fra en rekke arrangementsplattformer og billettselskaper. Velg og vrak – eller be oss integrere din favoritt.

Med vårt API har du tilgang til våre byer og mange partnerkanaler.

Logos of various ticketing platforms including Ticketmaster, Live Nation, and Eventim on a white background.

Vanlige spørsmål

Kom i gang

Hva er Townbase API?

Townbase API er et REST-API som gir utviklere og organisasjoner programmatisk tilgang til strukturert, kurert lokal arrangements- og innholdsdata. Det lar deg bygge inn live-arrangementsstrømmer, søk og oppdagelsesfunksjoner i hvilken som helst app, nettside eller digital tjeneste.

Hvem er API-et designet for?

API-et er designet for to målgrupper: utviklere som ønsker å bygge inn lokale oppdagelsesfunksjoner i produktene sine, og organisasjoner som kommuner, turistkontorer, DMO-er og mediegrupper som ønsker å distribuere innholdet sitt utover egne nettsider og tjenester.

Hvordan får jeg tilgang til API-et?

Kontakt Townbase for å be om en API-nøkkel. Når du har nøkkelen kan du begynne å gjøre forespørsler til alle offentlige endepunkter. Du må signere en avtale før du får nøkkelen.

Finnes det et sandkasse- eller testmiljø?

Ja – en test-API-nøkkel er tilgjengelig for utviklings- og testformål. Kontakt oss for å be om en.

Hvor lang tid tar en integrasjon vanligvis?

En grunnleggende integrasjon – som å bygge inn en arrangementsstrøm på en eksisterende nettside – kan være i gang på noen timer. En fullstendig skreddersydd oppdagelsesopplevelse tar vanligvis noen dager til noen uker avhengig av omfang.

Vanlige spørsmål

For kommuner og organisasjoner

Trenger jeg en utvikler for å bruke API-et?

API-et er utviklerorientert, men organisasjonen din trenger ikke ha en intern utvikler for å dra nytte av det. Townbase samarbeider med et nettverk av integrasjonspartnere og mange vanlige brukstilfeller har ferdige løsninger.

Hvem kontrollerer hvilket innhold som eksponeres via API-et?

Det gjør du. API-et eksponerer bare innhold som er publisert og godkjent på din Townbase-installasjon. Du beholder full redaksjonell kontroll til enhver tid.

Hva skjer med API-strømmen hvis jeg oppdaterer innhold på plattformen?

Endringer gjenspeiles i API-et i sanntid. Når du publiserer, redigerer eller sletter innhold på Townbase-plattformen din, oppdateres API-strømmen automatisk – ingen manuell synkronisering kreves.

Kan tredjepartsutviklere bygge kommersielle produkter med byens data?

Det avhenger av lisensavtalen. Townbase tilbyr den tekniske infrastrukturen og de kommersielle bruksvilkårene for innholdet ditt, men du bestemmer alltid hva som publiseres.

Inngår API-et i Townbase-lisensen min eller er det et separat tillegg?

API-tilgang er tilgjengelig som en del av utvalgte Townbase-planer. Kontakt oss for å bekrefte hva som inngår i din nåværende avtale.

Hvordan vet jeg hvem som bruker API-et mitt og hva de bygger?

API-nøkler utstedes per integrasjon, noe som gir deg innsyn i hvem som har tilgang til innholdsstrømmen din. Bruksrapportering er tilgjengelig via Townbase-dashboardet ditt.

Kan API-et hjelpe innholdet mitt å nå målgrupper jeg ikke når i dag?

Ja. API-et lar utviklere bygge innholdet ditt inn i apper, plattformer og tjenester som allerede har etablerte målgrupper – hotellkonsjerj-apper, nyhetsnettsteder, regionale turismportaler, digital skilting og mer – uten ekstra arbeid fra din side.

Hvilke byer og organisasjoner bruker dette allerede?

Townbase driver byguide-, lokal guide-, arrangements- og aktivitetsguide-plattformer for kommuner, medier og andre organisasjoner som universiteter i Finland, Sverige og Storbritannia. For øyeblikket har mer enn 50 000 organisasjoner registrert seg for å opprette innhold. Tampere by (tapahtumat.tampere.fi) er et offentlig tilgjengelig eksempel på en Townbase-drevet installasjon.

Vanlige spørsmål

For utviklere

Hvilket format returnerer API-et data i?

Alle API-svar er i JSON-format.

Hvordan autentiserer jeg forespørslene mine?

Autentisering håndteres via en API-nøkkel. Inkluder nøkkelen i forespørselshodet eller som en spørringsparameter i henhold til API-dokumentasjonen.

Finnes det en hastighetsbegrensning?

Ja, hastighetsbegrensninger gjelder for å forhindre misbruk og sikre pålitelighet for alle brukere. Detaljer gis med API-lisensvilkårene dine og er alltid forhandlingsbare.

Hvor ofte oppdateres innholdet – er det i sanntid?

Ja, innholdet oppdateres i sanntid. Så snart en utgiver oppdaterer et arrangement på plattformen, gjenspeiles endringen umiddelbart i API-svaret.

Hva inneholder et typisk objektsvar?

Et typisk objekt inkluderer tittel, beskrivelse, datoer og tider, plassering (long/lat), adresse, kategorier, tagger, målgrupper, bilder, arrangørinformasjon og språkvarianter der slike finnes.

Hvordan henter jeg bare kommende arrangementer?

Endepunktet /api/public/search støtter datoområdefiltrering, slik at du kan spørre bare om fremtidige arrangementer.

Kan jeg kombinere flere filtre i én søkeforespørsel?

Ja. Søkeendepunktet støtter kombinasjoner av filtre som kategori, område, tagg, målgruppe og datoområde i én enkelt forespørsel.

Hva brukes site/*-endepunktene til?

site/*-endepunktene – som dekker områder, kategorier, tagger, språk, målgrupper og arrangørsamlinger – eksponerer hele taksonomien for en installasjon. Det lar deg bygge helt dynamiske grensesnitt som ikke krever hardkodede verdier og tilpasser seg automatisk når plattformens innhold endres.

Finnes det et SDK?

For øyeblikket er API-et kun REST-basert uten offisielt SDK. Det er kompatibelt med ethvert språk eller rammeverk som kan gjøre HTTP-forespørsler.

Støtter API-et webhooks?

Webhooks er foreløpig ikke tilgjengelig. For sanntidsoppdateringer anbefaler vi at du poller relevante endepunkter med et passende intervall for ditt brukstilfelle.

Hvordan ser et typisk feilsvar ut?

Feil returneres som JSON med et error_type- og error_message-felt, noe som gjør dem enkle å håndtere programmatisk.

Er API-et versjonert?

Ja. Ikke bakoverkompatible endringer introduseres alltid under en ny versjon, og eksisterende versjoner støttes med varsel om avvikling.

Hvor finner jeg den fullstendige API-dokumentasjonen?

Fullstendig dokumentasjon inkludert endepunktreferanser, parametere og eksempelsvar er tilgjengelig på /api/docs/.

Vanlige spørsmål

Data og innhold

Hvilke typer innhold eksponerer API-et?

API-et eksponerer arrangementer, aktiviteter og lokale innholdsobjekter – inkludert kulturarrangementer, sport, samfunnsaktiviteter, utstillinger, konserter med mer, samt steder som arenaer, restauranter, hoteller osv – avhengig av hva som er publisert på hver installasjon.

Støtter API-et flere språk?

Ja. Endepunktet /api/public/site/languages returnerer tilgjengelige språk for en gitt installasjon, og innholdsobjekter inkluderer språkvarianter der utgiveren har gitt slike. For mer avanserte brukstilfeller tilbyr Townbase dynamiske oversettelser.

Kan jeg filtrere innhold etter målgruppe – for eksempel arrangementer for familier eller seniorer?

Ja. Endepunktet /api/public/site/targets returnerer alle tilgjengelige målgruppesegmenter for en installasjon, og disse kan brukes som filtre i søke- og innholdsforespørsler.

Kan jeg filtrere innhold etter geografisk område eller bydel?

Ja. Endepunktet /api/public/site/areas returnerer alle definerte geografiske områder (geoJSON-polygonbokser) for en installasjon, som kan brukes til å filtrere innhold etter plassering.

Er historisk innhold tilgjengelig, eller bare kommende arrangementer?

Både tidligere og kommende innhold er tilgjengelig via API-et. Datoområdeparametere i søkeendepunktet gir deg full kontroll over tidsvinduet du spør mot. Tilgang til historiske arrangementer krever at ytterligere parametere aktiveres.

Vanlige spørsmål

Brukstilfeller

Hva kan utviklere bygge med Townbase API?

Vanlige integrasjoner inkluderer by- og kommuneapper, turisme- og destinasjonsportaler, hotellkonsjerj- og hospitality-apper, regionale nyhets- og mediesider med automatiserte arrangementslister, digital skilting og offentlige skjermer, AI-assistenter og chatboter med lokal arrangementsbevissthet, samt kalenderapplikasjoner beriket med lokalt innhold som aktivitets- og hobbyguider. Hvis vi mangler et viktig kontaktpunkt, ser vi gjerne på å legge det til i partnerlisten vår.

Kan jeg bygge inn en live-arrangementsstrøm direkte på nettsiden min?

Ja. Endepunktet /api/public/content-by-host returnerer en strukturert liste med alt publisert innhold for en gitt installasjon, noe som gjør det enkelt å gjengi en live-arrangementsstrøm på hvilken som helst nettside eller app.

Kan jeg bygge en fullt merkevaretilpasset skreddersydd arrangementsguide med API-et?

Ja. API-et er designet for å støtte helt tilpassede frontend-opplevelser. All taksonomidata – kategorier, områder, tagger, målgrupper – er tilgjengelig dynamisk via site/*-endepunktene, slik at grensesnittet ditt kan gjenspeile plattformens innhold uten noen hardkoding.

Er API-et egnet for AI- og chatbot-integrasjoner?

Ja. De strukturerte JSON-svarene og søkefunksjonene gjør Townbase API godt egnet for å drive AI-assistenter, stemmebrukerfeil og chatboter som trenger å svare på spørsmål om lokale arrangementer og aktiviteter. Noen kunder bruker det for stemmeassistenter av tilgjengelighetsgrunner, andre ønsker å tilby en lokal guide via et agentbasert grensesnitt. Be om eksempler.