Billetto API-dokumentation og webhooks-guide
Det kan du bygge med Billettos API
Billettos API er et REST API, der returnerer JSON. Det giver din egen kode adgang til de samme data, som driver dit billetsalg: events, billettyper, ordrer, deltagere, posteringer, bookingspørgsmål og målgrupper. Webhooks sender ændringer til dig, når de sker, så du ikke behøver at spørge efter dem.
Teams bruger det til at synkronisere købere til et CRM, indlæse salg i et data warehouse, vise events på deres egen hjemmeside, tilføje medlemmer til presale-målgrupper og afstemme udbetalinger i økonomisystemet. Denne side forklarer, hvordan API'et er opbygget, og hvordan webhooks fungerer. Det fulde skema for hvert endpoint finder du i API-referencen.
Start her
- Kom i gang-guide: opret adgangsnøgler og lav dit første kald
- API-reference: alle endpoints, parametre og svarobjekter
- Webhook-reference: webhook-ressourcen og dens felter
- Public Event Search: hent offentligt tilgængelige events på Billetto
Godkend med et API-nøglepar eller OAuth 2.0
API-nøglepar til din egen konto
Brug et nøglepar, når dine egne systemer kalder API'et på vegne af din arrangørkonto. Opret et i Billetto under Integrations → Developers → API - Key pairs, giv det et navn, der siger, hvad det bruges til (for eksempel "CRM-synk" eller "Data warehouse"), og send det med hvert kald i headeren Api-Keypair.
- Opret et separat nøglepar pr. system, så du kan tilbagekalde ét uden at påvirke de andre
- Hold hemmeligheden på din server. Læg den aldrig i en browser, en mobilapp eller et offentligt repository
- Tilbagekald og erstat et nøglepar med det samme, hvis du tror, det er lækket
OAuth 2.0 til apps, som andre arrangører bruger
Brug OAuth, når du bygger et produkt, som andre Billetto-arrangører forbinder til, for eksempel et marketingværktøj, en eventplatform eller et bureau-dashboard. OAuth bruger authorization code-flowet: arrangøren logger ind på Billetto, godkender din app, og du modtager et token til deres konto. Du ser aldrig deres adgangskode, og de kan til enhver tid afbryde forbindelsen.
Begge metoder er beskrevet trin for trin i kom i gang-guiden.
- Events
- Ordrer og deltagere
- Økonomi og rapporter
- Audiences
- Webhooks
- Offentlige events
Events og billettyper
Hent events på din konto med datoer, spillesteder, status og billettyper.
GET /organiser/eventsviser dine events- Billettyper, priser og tilgængelighed pr. event
- Bookingspørgsmål, du stiller køberne ved checkout
Typisk brug
Vis dine kommende events på din egen hjemmeside eller app med live tilgængelighed, og send køberne videre til Billettos checkout.
Ordrer og deltagere
Se, hvem der har købt hvad, hvornår og til hvilket event.
GET /organiser/ordersviser ordrer på tværs af dine eventsGET /organiser/events/{event_id}/attendeesviser deltagere til ét event- Resultaterne kommer i sider: bliv ved med at hente næste side, til der ikke er flere
Typisk brug
Hold køberdata i dit CRM opdateret, eller send deltagerlister til et adgangssystem eller akkrediteringsværktøj.
Posteringer og rapporter
Få de økonomiske detaljer bag dit billetsalg.
GET /organiser/ledger_entriesviser salg, refusioner, gebyrer og udbetalinger- En BI-rapport pr. event med de vigtigste salgstal
Typisk brug
Indlæs omsætning i dit regnskabssystem eller data warehouse, og afstem den med dine udbetalinger.
Målgrupper og medlemmer
Skriv data tilbage til Billetto, ikke kun hent dem.
- Opret, opdater og fjern medlemmer af målgrupper
- Importér hele lister, og følg status på importen
- Hent en målgruppe og dens antal medlemmer
Typisk brug
Synkronisér medlemmer, abonnenter eller partnerlister fra dit CRM til Audiences til presales og lukkede tilbud.
Webhook-abonnementer
Administrér webhooks i kode i stedet for i Billettos brugerflade.
POST /organiser/webhooksregistrerer en endpoint-URL- Opdatér eller fjern en eksisterende webhook
- Generér en ny signeringsnøgle til en webhook
Typisk brug
Registrér webhooks automatisk, når en ny kunde eller et nyt miljø sættes op, og udskift nøgler efter en fast plan.
Public Event Search
Søg i de events, der er offentligt listet på Billetto, på tværs af arrangører.
- Forespørgselsparametre til at indsnævre resultaterne, beskrevet i referencen
- Hvert resultat linker til eventsiden og checkout
Typisk brug
Medier, byguides og partnerplatforme bruger det til at vise, hvad der sker, med billetter solgt via Billetto.
SE DET I PRAKSIS
Billettos API og webhooks, trin for trin
APITrin 1: adgang
Opret et nøglepar, og lav dit første kald
Åbn Integrations, gå til fanen Developers, og opret et nøglepar til det system, du forbinder. Kopiér hemmeligheden, tilføj den til dine request headers, og kald et endpoint som /organiser/orders. Svaret er JSON, som du kan mappe direkte til din egen datamodel.
- Ét nøglepar pr. integration, opkaldt efter systemet, der bruger det
- JSON-svar for events, ordrer, deltagere og posteringer
- Tilbagekald et nøglepar når som helst uden at påvirke de andre
Integrations
Example dataAPI - Key pairs
+ Create key pairAUDIENCESTrin 2: skriv til Billetto
Tilføj kontakter til en målgruppe via API'et
Audiences-endpoints er den primære måde at skrive data ind i Billetto på. Send kontakter fra dit CRM til en målgruppe, eller importér en hel liste og tjek status, til den er færdig. Derefter er gruppen klar til invitationer, presales og lukkede tilbud.
- Tilføj, opdatér og fjern medlemmer ét ad gangen
- Masseimport med en status, du kan følge
- Grupperne vises i Audiences med det samme
Audiences
Example dataVIP members 2026Synced via API
WEBHOOKSTrin 3: Billetto webhooks
Registrér en webhook, og se leveringerne komme ind
Tilføj din endpoint-URL på fanen Developers, så genererer Billetto en signeringsnøgle til den. Herefter sendes hver ordre, refusion, deltagerændring eller publiceret event til din URL som et HTTP POST med en JSON-body.
- Opsæt i brugerfladen eller med POST /organiser/webhooks
- En signeringsnøgle pr. webhook, som du kan generere på ny
- Webhooks-kortet viser URL og API-version for hver webhook
Integrations
Example dataWebhooks
Receive data based on specific webhook events
Recent deliveriesLive
Hvad Billettos webhooks er, og hvornår du skal bruge dem
En webhook er en URL på din server, som Billetto kalder, når noget ændrer sig på din konto. I stedet for at spørge API'et hvert par minutter, om der er nye ordrer, får du et kald i det øjeblik, en ordre oprettes, refunderes eller opdateres.
Derfor er webhooks det rigtige værktøj, når timing betyder noget: en bekræftelse i dit CRM på få sekunder, en Slack-besked når en VIP-billet bliver solgt, eller et adgangssystem, der skal kende til en annulleret billet, før dørene åbner.
Webhooks eller API?
- Brug webhooks til at reagere på ændringer, når de sker: nye ordrer, refusioner, deltagerændringer og publicerede events
- Brug API'et til at hente historik, køre en fuld synkronisering hver nat eller hente detaljer, som en webhook ikke indeholder
- Brug begge for den mest robuste opsætning: webhooks for hastighed og en planlagt API-synk for at fange alt, du måtte have misset
Sådan leveres en Billetto-webhook
Fra det øjeblik en billet bliver solgt, til dit system har behandlet den.Byg en webhook-modtager, du kan stole på
Sikkerhed
- Verificér hvert kald med webhookens signeringsnøgle, før du stoler på indholdet. Webhook-referencen beskriver hvordan
- Accepter kun HTTPS, og gem nøglen i konfigurationen på serveren, ikke i din kode
- Generér nøglen på ny, hvis den kan være blevet afsløret, og opdatér derefter din modtager
Driftssikkerhed
- Svar hurtigt. Returnér en 2xx-status, så snart kaldet er verificeret, og lad det tunge arbejde ligge i en kø
- Håndtér dubletter. Gem de ID'er, du har behandlet, så den samme ordre aldrig oprettes to gange
- Regn ikke med rækkefølgen. Hvis rækkefølgen betyder noget, så hent ordrens seneste status fra API'et
- Afstem jævnligt. En planlagt API-synk fanger alt, hvad dit endpoint missede under nedetid
Billettos API-reference
API-referencen dokumenterer hvert endpoint med parametre, eksempler på kald og svarobjekter. Brug den sammen med denne guide, når du går i gang med at kode: find den ressource, du har brug for ovenfor, og slå de præcise felter op i referencen.
Webhook-reference
Webhook-ressourcen indeholder konfigurationen af et endpoint: URL'en, den API-version det bruger, og signeringsnøglen. Vi anbefaler, at du opretter din første webhook i Billetto under Integrations → Developers og derefter administrerer den via API'et, når din opsætning vokser.
Public Event Search API
Public Event Search API returnerer events, som arrangører har listet offentligt på Billetto, på tværs af alle arrangører. Det passer til mediesites, byguides, turistorganisationer og partnerapps, der vil vise, hvad der sker, hvor hvert resultat linker til Billettos eventside, hvor billetterne købes.
Spørgsmål om Billettos API og webhooks
Tekniske spørgsmål fra udviklere, der arbejder med Billettos API. Mangler du et svar? Tal med vores team.
Log ind på Billetto, åbn Integrations, og gå til fanen Developers. Under API - Key pairs kan du oprette et nyt nøglepar, se hvem der ejer hvert enkelt, og tilbagekalde nøgler, du ikke længere bruger.
Et nøglepar giver dine egne systemer adgang til din egen arrangørkonto. OAuth 2.0 er til apps, som andre arrangører forbinder til deres Billetto-konto, så du handler på deres vegne uden at kende deres login.
Webhooks dækker ændringer i ordrer, deltagere og events, for eksempel nye ordrer, refusioner, deltagerændringer og publicerede events. Webhook-referencen viser alle hændelser og deres indhold.
Hver webhook har sin egen signeringsnøgle. Brug den til at tjekke hvert indkommende kald, før du behandler det, og afvis kald, der ikke består tjekket. Du kan til enhver tid generere en ny nøgle til en webhook.
Ja. Du kan registrere, opdatere og fjerne webhooks med webhook-endpoints og generere en ny signeringsnøgle til en eksisterende webhook. De fleste teams starter i brugerfladen og går over til API'et, når de har flere miljøer.
429 betyder, at du sender for mange kald. Vent, og prøv igen med en stigende pause, og brug webhooks i stedet for hyppig polling for at holde antallet af kald nede.
Ja. Brug Public Event Search API til events, der er listet offentligt på Billetto, eller arrangørens events-endpoint til dine egne events. Køberne gennemfører købet i Billettos checkout.
Ja. Google Analytics 4, Meta Pixel, Zapier og din egen betalingsudbyder kan forbindes uden kode. Se Billettos integrationer for det, du kan sætte op på få minutter.
