Billetto API-dokumentasjon og webhooks-guide
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
- Kom i gang-guide: opprett tilgangsnøkler og gjør ditt første kall
- API-referanse: alle endepunkter, parametere og svarobjekter
- Webhook-referanse: webhook-ressursen og feltene den har
- Public Event Search: hent offentlig tilgjengelige arrangementer på Billetto
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
- Ordrer og deltakere
- Økonomi og rapporter
- Audiences
- Webhooks
- Offentlige arrangementer
Arrangementer og billettyper
Hent arrangementene på kontoen din med datoer, steder, status og billettyper.
GET /organiser/eventsviser 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/ordersviser ordrer på tvers av arrangementene dineGET /organiser/events/{event_id}/attendeesviser 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_entriesviser 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/webhooksregistrerer 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
Integrations
Example dataAPI - Key pairs
+ Create key pairAUDIENCESSteg 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
Audiences
Example dataVIP members 2026Synced via API
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
Integrations
Example dataWebhooks
Receive data based on specific webhook events
Recent deliveriesLive
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 leveres en Billetto-webhook
Fra en billett blir solgt til systemet ditt har behandlet den.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
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-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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Denmark