Skip to content

Billetto API-dokumentation og webhooks-guide

Sådan godkender du dig, hvilke endpoints du skal kalde, og hvordan Billettos webhooks sender billetdata til dine systemer i realtid. Tekniske guides til udviklere, der bygger på Billetto.
DEVELOPER HUB

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

GODKENDELSE

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 og billettyper

Hent events på din konto med datoer, spillesteder, status og billettyper.

  • GET /organiser/events viser 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/orders viser ordrer på tværs af dine events
  • GET /organiser/events/{event_id}/attendees viser 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_entries viser 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/webhooks registrerer 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
Åbn API-referencen

AUDIENCESTrin 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

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
Læs webhook-referencen
BILLETTO WEBHOOKS

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 VIRKER DET

Sådan leveres en Billetto-webhook

Fra det øjeblik en billet bliver solgt, til dit system har behandlet den.
1
REGISTRÉR DIT ENDPOINT
Tilføj en offentlig HTTPS-URL på fanen Developers eller via API'et, og gem den signeringsnøgle, Billetto giver dig.
2
NOGET ÆNDRER SIG
En køber afgiver en ordre, en billet refunderes, en deltagers oplysninger opdateres, eller du publicerer et event.
3
BILLETTO SENDER ET POST
Billetto sender et HTTP POST til din URL med en JSON-body, der beskriver ændringen.
4
VERIFICÉR OG SVAR
Tjek kaldet med din signeringsnøgle, svar med en 2xx-status, og behandl dataene i baggrunden.
BEST PRACTICES FOR WEBHOOKS

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
Fuld dokumentation af endpoints

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

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.

Offentlige events på tværs af arrangører

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.

FAQ OM API OG WEBHOOKS

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.

Hvor finder jeg min Billetto API-nøgle?

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.

Hvad er forskellen på et API-nøglepar og OAuth?

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.

Hvilke hændelser kan Billettos webhooks sende?

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.

Hvordan verificerer jeg, at et webhook-kald kommer fra Billetto?

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.

Kan jeg oprette webhooks via API'et?

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.

Hvad gør jeg, hvis jeg får et HTTP 429-svar?

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.

Kan jeg vise Billetto-events på min egen hjemmeside eller platform?

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.

Jeg er ikke udvikler. Kan jeg stadig forbinde Billetto med andre værktøjer?

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.

Klar til dit første kald?

Opret et nøglepar under Integrations, åbn referencen, og kald dit første endpoint. Vil du hellere forbinde Google Analytics, Meta Pixel eller Zapier uden at skrive kode, så start med Billettos integrationer.