Skip to content

Billetto API-dokumentasjon og webhooks-guide

Slik autentiserer du deg, hvilke endepunkter du skal kalle, og hvordan Billettos webhooks sender billettdata til systemene dine i sanntid. Tekniske guider for utviklere som bygger på Billetto.
DEVELOPER HUB

Dette kan du bygge med Billettos API

Billettos API er et REST API som returnerer JSON. Det gir din egen kode tilgang til de samme dataene som driver billettsalget ditt: arrangementer, billettyper, ordrer, deltakere, posteringer, bestillingsspørsmål og målgrupper. Webhooks sender endringer til deg når de skjer, så du slipper å spørre etter dem.

Team bruker det til å synkronisere kjøpere til et CRM, laste salg inn i et datavarehus, vise arrangementer på sin egen nettside, legge til medlemmer i presale-målgrupper og avstemme utbetalinger i økonomisystemet. Denne siden forklarer hvordan API-et er bygget opp og hvordan webhooks fungerer. Det fullstendige skjemaet for hvert endepunkt finner du i API-referansen.

Start her

AUTENTISERING

Autentiser med et API-nøkkelpar eller OAuth 2.0

API-nøkkelpar for din egen konto

Bruk et nøkkelpar når dine egne systemer kaller API-et på vegne av arrangørkontoen din. Opprett et i Billetto under Integrations → Developers → API - Key pairs, gi det et navn som viser hva det brukes til (for eksempel "CRM-synk" eller "Datavarehus"), og send det med hvert kall i headeren Api-Keypair.

  • Opprett et eget nøkkelpar per system, så du kan trekke tilbake ett uten å påvirke de andre
  • Hold hemmeligheten på serveren din. Legg den aldri i en nettleser, en mobilapp eller et offentlig repository
  • Trekk tilbake og erstatt et nøkkelpar med en gang hvis du tror det har lekket

OAuth 2.0 for apper som andre arrangører bruker

Bruk OAuth når du bygger et produkt som andre Billetto-arrangører kobler seg til, for eksempel et markedsføringsverktøy, en eventplattform eller et byrå-dashboard. OAuth bruker authorization code-flyten: arrangøren logger inn på Billetto, godkjenner appen din, og du får et token for kontoen deres. Du ser aldri passordet deres, og de kan når som helst koble fra appen din.

Begge metodene er beskrevet steg for steg i kom i gang-guiden.

Arrangementer og billettyper

Hent arrangementene på kontoen din med datoer, steder, status og billettyper.

  • GET /organiser/events viser arrangementene dine
  • Billettyper, priser og tilgjengelighet per arrangement
  • Bestillingsspørsmål du stiller kjøperne i kassen

Typisk bruk

Vis kommende arrangementer på din egen nettside eller app med tilgjengelighet i sanntid, og send kjøperne videre til Billettos kasse.

Ordrer og deltakere

Se hvem som kjøpte hva, når og til hvilket arrangement.

  • GET /organiser/orders viser ordrer på tvers av arrangementene dine
  • GET /organiser/events/{event_id}/attendees viser deltakere for ett arrangement
  • Resultatene kommer i sider: fortsett å hente neste side til det ikke er flere

Typisk bruk

Hold kjøperdataene i CRM-et ditt oppdatert, eller send deltakerlister til et adgangssystem eller akkrediteringsverktøy.

Posteringer og rapporter

Få de økonomiske detaljene bak billettsalget ditt.

  • GET /organiser/ledger_entries viser salg, refusjoner, gebyrer og utbetalinger
  • En BI-rapport per arrangement med de viktigste salgstallene

Typisk bruk

Last inntekter inn i regnskapssystemet eller datavarehuset ditt, og avstem dem mot utbetalingene.

Målgrupper og medlemmer

Skriv data tilbake til Billetto, ikke bare les dem.

  • Opprett, oppdater og fjern medlemmer i målgrupper
  • Importer hele lister og følg status på importen
  • Hent en målgruppe og antall medlemmer

Typisk bruk

Synkroniser medlemmer, abonnenter eller partnerlister fra CRM-et ditt til Audiences for presales og lukkede tilbud.

Webhook-abonnementer

Administrer webhooks i kode i stedet for i Billettos brukergrensesnitt.

  • POST /organiser/webhooks registrerer en endepunkt-URL
  • Oppdater eller fjern en eksisterende webhook
  • Generer en ny signeringsnøkkel for en webhook

Typisk bruk

Registrer webhooks automatisk når en ny kunde eller et nytt miljø settes opp, og bytt nøkler etter en fast plan.

Public Event Search

Søk i arrangementer som er offentlig listet på Billetto, på tvers av arrangører.

  • Spørreparametere for å avgrense resultatene, beskrevet i referansen
  • Hvert resultat lenker til arrangementssiden og kassen

Typisk bruk

Medier, byguider og partnerplattformer bruker det til å vise hva som skjer, med billetter solgt via Billetto.

SE DET I PRAKSIS

Billettos API og webhooks, steg for steg

APISteg 1: tilgang

Opprett et nøkkelpar og gjør ditt første kall

Åpne Integrations, gå til fanen Developers og opprett et nøkkelpar for systemet du kobler til. Kopier hemmeligheten, legg den til i request headers og kall et endepunkt som /organiser/orders. Svaret er JSON som du kan mappe direkte til din egen datamodell.

  • Ett nøkkelpar per integrasjon, oppkalt etter systemet som bruker det
  • JSON-svar for arrangementer, ordrer, deltakere og posteringer
  • Trekk tilbake et nøkkelpar når som helst uten å påvirke de andre
Åpne API-referansen

AUDIENCESSteg 2: skriv til Billetto

Legg til kontakter i en målgruppe via API-et

Audiences-endepunktene er den viktigste måten å skrive data inn i Billetto på. Send kontakter fra CRM-et ditt til en målgruppe, eller importer en hel liste og sjekk statusen til den er ferdig. Deretter er gruppen klar for invitasjoner, presales og lukkede tilbud.

  • Legg til, oppdater og fjern medlemmer ett om gangen
  • Masseimport med en status du kan følge
  • Gruppene vises i Audiences med en gang

WEBHOOKSSteg 3: Billetto webhooks

Registrer en webhook og se leveransene komme inn

Legg til endepunkt-URL-en din på fanen Developers, så genererer Billetto en signeringsnøkkel for den. Deretter sendes hver ordre, refusjon, deltakerendring eller publisert arrangement til URL-en din som en HTTP POST med en JSON-body.

  • Sett opp i brukergrensesnittet eller med POST /organiser/webhooks
  • En signeringsnøkkel per webhook, som du kan generere på nytt
  • Webhooks-kortet viser URL og API-versjon for hver webhook
Les webhook-referansen
BILLETTO WEBHOOKS

Hva Billettos webhooks er, og når du bør bruke dem

En webhook er en URL på serveren din som Billetto kaller når noe endrer seg på kontoen din. I stedet for å spørre API-et med noen minutters mellomrom om det finnes nye ordrer, får du et kall i det øyeblikket en ordre opprettes, refunderes eller oppdateres.

Derfor er webhooks riktig verktøy når timing betyr noe: en bekreftelse i CRM-et ditt på få sekunder, en Slack-melding når en VIP-billett blir solgt, eller et adgangssystem som må vite om en kansellert billett før dørene åpner.

Webhooks eller API?

  • Bruk webhooks for å reagere på endringer når de skjer: nye ordrer, refusjoner, deltakerendringer og publiserte arrangementer
  • Bruk API-et for å hente historikk, kjøre en full synkronisering hver natt eller hente detaljer som en webhook ikke inneholder
  • Bruk begge for det mest robuste oppsettet: webhooks for hastighet og en planlagt API-synk som fanger opp det du kan ha gått glipp av
SLIK FUNGERER DET

Slik leveres en Billetto-webhook

Fra en billett blir solgt til systemet ditt har behandlet den.
1
REGISTRER ENDEPUNKTET DITT
Legg til en offentlig HTTPS-URL på fanen Developers eller via API-et, og lagre signeringsnøkkelen Billetto gir deg.
2
NOE ENDRER SEG
En kjøper legger inn en ordre, en billett refunderes, en deltakers opplysninger oppdateres eller du publiserer et arrangement.
3
BILLETTO SENDER EN POST
Billetto sender en HTTP POST til URL-en din med en JSON-body som beskriver endringen.
4
VERIFISER OG SVAR
Sjekk kallet med signeringsnøkkelen din, svar med en 2xx-status og behandle dataene i bakgrunnen.
BEST PRACTICES FOR WEBHOOKS

Bygg en webhook-mottaker du kan stole på

Sikkerhet

  • Verifiser hvert kall med webhookens signeringsnøkkel før du stoler på innholdet. Webhook-referansen beskriver hvordan
  • Godta bare HTTPS og lagre nøkkelen i serverkonfigurasjonen, ikke i koden din
  • Generer en ny nøkkel hvis den kan ha blitt eksponert, og oppdater deretter mottakeren din

Driftssikkerhet

  • Svar raskt. Returner en 2xx-status så snart kallet er verifisert, og legg det tunge arbeidet i en kø
  • Håndter duplikater. Lagre ID-ene du har behandlet, så samme ordre aldri opprettes to ganger
  • Ikke stol på rekkefølgen. Hvis rekkefølgen betyr noe, hent siste status for ordren fra API-et
  • Avstem jevnlig. En planlagt API-synk fanger opp det endepunktet ditt gikk glipp av under nedetid
Full dokumentasjon av endepunkter

Billettos API-referanse

API-referansen dokumenterer hvert endepunkt med parametere, eksempelkall og svarobjekter. Bruk den sammen med denne guiden når du begynner å kode: finn ressursen du trenger ovenfor, og slå deretter opp de nøyaktige feltene i referansen.

Webhook-ressursen

Webhook-referanse

Webhook-ressursen inneholder konfigurasjonen for et endepunkt: URL-en, API-versjonen det bruker og signeringsnøkkelen. Vi anbefaler at du oppretter din første webhook i Billetto under Integrations → Developers, og deretter administrerer den via API-et når oppsettet ditt vokser.

Offentlige arrangementer på tvers av arrangører

Public Event Search API

Public Event Search API returnerer arrangementer som arrangører har listet offentlig på Billetto, på tvers av alle arrangører. Det passer for mediesider, byguider, reiselivsorganisasjoner og partnerapper som vil vise hva som skjer, der hvert resultat lenker til Billettos arrangementsside der billettene kjøpes.

FAQ OM API OG WEBHOOKS

Spørsmål om Billettos API og webhooks

Tekniske spørsmål fra utviklere som jobber med Billettos API. Mangler du et svar? Snakk med teamet vårt.

Hvor finner jeg Billetto API-nøkkelen min?

Logg inn på Billetto, åpne Integrations og gå til fanen Developers. Under API - Key pairs kan du opprette et nytt nøkkelpar, se hvem som eier hvert par og trekke tilbake nøkler du ikke lenger bruker.

Hva er forskjellen på et API-nøkkelpar og OAuth?

Et nøkkelpar gir dine egne systemer tilgang til din egen arrangørkonto. OAuth 2.0 er for apper som andre arrangører kobler til Billetto-kontoen sin, slik at du handler på deres vegne uten å håndtere innloggingen deres.

Hvilke hendelser kan Billettos webhooks sende?

Webhooks dekker endringer i ordrer, deltakere og arrangementer, for eksempel nye ordrer, refusjoner, deltakerendringer og publiserte arrangementer. Webhook-referansen viser alle hendelser og innholdet deres.

Hvordan verifiserer jeg at et webhook-kall kommer fra Billetto?

Hver webhook har sin egen signeringsnøkkel. Bruk den til å sjekke hvert innkommende kall før du behandler det, og avvis kall som ikke består sjekken. Du kan når som helst generere en ny nøkkel for en webhook.

Kan jeg opprette webhooks via API-et?

Ja. Du kan registrere, oppdatere og fjerne webhooks med webhook-endepunktene, og generere en ny signeringsnøkkel for en eksisterende webhook. De fleste team starter i brukergrensesnittet og går over til API-et når de har flere miljøer.

Hva gjør jeg hvis jeg får et HTTP 429-svar?

429 betyr at du sender for mange kall. Vent og prøv igjen med en økende pause, og bruk webhooks i stedet for hyppig polling for å holde antall kall nede.

Kan jeg vise Billetto-arrangementer på min egen nettside eller plattform?

Ja. Bruk Public Event Search API for arrangementer som er offentlig listet på Billetto, eller arrangørens events-endepunkt for dine egne arrangementer. Kjøperne fullfører kjøpet i Billettos kasse.

Jeg er ikke utvikler. Kan jeg likevel koble Billetto til andre verktøy?

Ja. Google Analytics 4, Meta Pixel, Zapier og din egen betalingsleverandør kobles til uten kode. Se Billettos integrasjoner for det du kan sette opp på noen minutter.

Klar for ditt første kall?

Opprett et nøkkelpar under Integrations, åpne referansen og kall ditt første endepunkt. Vil du heller koble til Google Analytics, Meta Pixel eller Zapier uten å skrive kode, start med Billettos integrasjoner.