Skip to content

Billetto API-dokumentation och webhooks-guide

Så autentiserar du dig, vilka endpoints du ska anropa och hur Billettos webhooks skickar biljettdata till dina system i realtid. Tekniska guider för utvecklare som bygger på Billetto.
DEVELOPER HUB

Det här kan du bygga med Billettos API

Billettos API är ett REST API som returnerar JSON. Det ger din egen kod tillgång till samma data som driver din biljettförsäljning: evenemang, biljettyper, ordrar, deltagare, bokföringsposter, bokningsfrågor och målgrupper. Webhooks skickar ändringar till dig när de sker, så att du slipper fråga efter dem.

Team använder det för att synka köpare till ett CRM, läsa in försäljning i ett data warehouse, visa evenemang på sin egen webbplats, lägga till medlemmar i presale-målgrupper och stämma av utbetalningar i ekonomisystemet. Den här sidan förklarar hur API:et är uppbyggt och hur webhooks fungerar. Det fullständiga schemat för varje endpoint finns i API-referensen.

Börja här

AUTENTISERING

Autentisera med ett API-nyckelpar eller OAuth 2.0

API-nyckelpar för ditt eget konto

Använd ett nyckelpar när dina egna system anropar API:et för ditt arrangörskontos räkning. Skapa ett i Billetto under Integrations → Developers → API - Key pairs, ge det ett namn som visar vad det används till (till exempel "CRM-synk" eller "Data warehouse") och skicka det med varje anrop i headern Api-Keypair.

  • Skapa ett separat nyckelpar per system, så att du kan återkalla ett utan att påverka de andra
  • Håll hemligheten på din server. Lägg den aldrig i en webbläsare, en mobilapp eller ett publikt repository
  • Återkalla och ersätt ett nyckelpar direkt om du tror att det har läckt

OAuth 2.0 för appar som andra arrangörer använder

Använd OAuth när du bygger en produkt som andra Billetto-arrangörer kopplar till, till exempel ett marknadsföringsverktyg, en eventplattform eller en byrådashboard. OAuth använder authorization code-flödet: arrangören loggar in på Billetto, godkänner din app och du får en token för deras konto. Du ser aldrig deras lösenord och de kan när som helst koppla bort din app.

Båda metoderna beskrivs steg för steg i kom igång-guiden.

Evenemang och biljettyper

Hämta evenemangen på ditt konto med datum, platser, status och biljettyper.

  • GET /organiser/events listar dina evenemang
  • Biljettyper, priser och tillgänglighet per evenemang
  • Bokningsfrågor som du ställer till köparna i kassan

Typisk användning

Visa dina kommande evenemang på din egen webbplats eller app med tillgänglighet i realtid, och skicka köparna vidare till Billettos kassa.

Ordrar och deltagare

Se vem som köpte vad, när och till vilket evenemang.

  • GET /organiser/orders listar ordrar för alla dina evenemang
  • GET /organiser/events/{event_id}/attendees listar deltagare för ett evenemang
  • Resultaten kommer i sidor: fortsätt hämta nästa sida tills det inte finns fler

Typisk användning

Håll köparuppgifterna i ditt CRM uppdaterade eller skicka deltagarlistor till ett insläppssystem eller ackrediteringsverktyg.

Bokföringsposter och rapporter

Få de ekonomiska detaljerna bakom din biljettförsäljning.

  • GET /organiser/ledger_entries listar försäljning, återbetalningar, avgifter och utbetalningar
  • En BI-rapport per evenemang med de viktigaste försäljningssiffrorna

Typisk användning

Läs in intäkter i ditt bokföringssystem eller data warehouse och stäm av dem mot dina utbetalningar.

Målgrupper och medlemmar

Skriv data tillbaka till Billetto, inte bara läs den.

  • Skapa, uppdatera och ta bort medlemmar i målgrupper
  • Importera hela listor och följ importens status
  • Hämta en målgrupp och dess antal medlemmar

Typisk användning

Synka medlemmar, prenumeranter eller partnerlistor från ditt CRM till Audiences för presales och slutna erbjudanden.

Webhook-prenumerationer

Hantera webhooks i kod i stället för i Billettos gränssnitt.

  • POST /organiser/webhooks registrerar en endpoint-URL
  • Uppdatera eller ta bort en befintlig webhook
  • Generera en ny signeringsnyckel för en webhook

Typisk användning

Registrera webhooks automatiskt när en ny kund eller miljö sätts upp, och byt nycklar enligt ett schema.

Public Event Search

Sök bland evenemang som listas offentligt på Billetto, från alla arrangörer.

  • Frågeparametrar för att avgränsa resultaten, beskrivna i referensen
  • Varje resultat länkar till evenemangssidan och kassan

Typisk användning

Medier, stadsguider och partnerplattformar använder det för att visa vad som händer, med biljetter som säljs via Billetto.

SE DET I PRAKTIKEN

Billettos API och webhooks, steg för steg

APISteg 1: åtkomst

Skapa ett nyckelpar och gör ditt första anrop

Öppna Integrations, gå till fliken Developers och skapa ett nyckelpar för systemet du kopplar in. Kopiera hemligheten, lägg till den i dina request headers och anropa en endpoint som /organiser/orders. Svaret är JSON som du kan mappa direkt till din egen datamodell.

  • Ett nyckelpar per integration, namngivet efter systemet som använder det
  • JSON-svar för evenemang, ordrar, deltagare och bokföringsposter
  • Återkalla ett nyckelpar när som helst utan att påverka de andra
Öppna API-referensen

AUDIENCESSteg 2: skriv till Billetto

Lägg till kontakter i en målgrupp via API:et

Audiences-endpoints är det huvudsakliga sättet att skriva data till Billetto. Skicka kontakter från ditt CRM till en målgrupp, eller importera en hel lista och kontrollera statusen tills den är klar. Därefter är gruppen redo för inbjudningar, presales och slutna erbjudanden.

  • Lägg till, uppdatera och ta bort medlemmar en i taget
  • Massimport med en status du kan följa
  • Grupperna syns i Audiences direkt

WEBHOOKSSteg 3: Billetto webhooks

Registrera en webhook och se leveranserna komma in

Lägg till din endpoint-URL på fliken Developers så genererar Billetto en signeringsnyckel för den. Därefter skickas varje order, återbetalning, deltagarändring eller publicerat evenemang till din URL som en HTTP POST med en JSON-body.

  • Sätt upp i gränssnittet eller med POST /organiser/webhooks
  • En signeringsnyckel per webhook, som du kan generera på nytt
  • Webhooks-kortet visar URL och API-version för varje webhook
Läs webhook-referensen
BILLETTO WEBHOOKS

Vad Billettos webhooks är och när du ska använda dem

En webhook är en URL på din server som Billetto anropar när något ändras på ditt konto. I stället för att fråga API:et med några minuters mellanrum om det finns nya ordrar får du ett anrop i samma ögonblick som en order skapas, återbetalas eller uppdateras.

Därför är webhooks rätt verktyg när timing spelar roll: en bekräftelse i ditt CRM inom några sekunder, ett Slack-meddelande när en VIP-biljett säljs, eller ett insläppssystem som måste känna till en avbokad biljett innan dörrarna öppnar.

Webhooks eller API?

  • Använd webhooks för att reagera på ändringar när de sker: nya ordrar, återbetalningar, deltagarändringar och publicerade evenemang
  • Använd API:et för att hämta historik, köra en fullständig synk varje natt eller hämta detaljer som en webhook inte innehåller
  • Använd båda för den mest pålitliga lösningen: webhooks för snabbhet och en schemalagd API-synk som fångar upp det du kan ha missat
SÅ FUNGERAR DET

Så levereras en Billetto-webhook

Från det ögonblick en biljett säljs tills ditt system har behandlat den.
1
REGISTRERA DIN ENDPOINT
Lägg till en publik HTTPS-URL på fliken Developers eller via API:et och spara signeringsnyckeln som Billetto ger dig.
2
NÅGOT ÄNDRAS
En köpare lägger en order, en biljett återbetalas, en deltagares uppgifter uppdateras eller du publicerar ett evenemang.
3
BILLETTO SKICKAR EN POST
Billetto skickar en HTTP POST till din URL med en JSON-body som beskriver ändringen.
4
VERIFIERA OCH SVARA
Kontrollera anropet med din signeringsnyckel, svara med en 2xx-status och behandla datan i bakgrunden.
BEST PRACTICES FÖR WEBHOOKS

Bygg en webhook-mottagare du kan lita på

Säkerhet

  • Verifiera varje anrop med webhookens signeringsnyckel innan du litar på innehållet. Webhook-referensen beskriver hur
  • Acceptera bara HTTPS och spara nyckeln i serverns konfiguration, inte i din kod
  • Generera en ny nyckel om den kan ha exponerats och uppdatera sedan din mottagare

Driftsäkerhet

  • Svara snabbt. Returnera en 2xx-status så snart anropet är verifierat och lägg det tunga arbetet i en kö
  • Hantera dubbletter. Spara de ID:n du har behandlat så att samma order aldrig skapas två gånger
  • Räkna inte med ordningen. Om ordningen spelar roll, hämta orderns senaste status från API:et
  • Stäm av regelbundet. En schemalagd API-synk fångar upp det din endpoint missade under driftstopp
Fullständig dokumentation av endpoints

Billettos API-referens

API-referensen dokumenterar varje endpoint med parametrar, exempelanrop och svarsobjekt. Använd den tillsammans med den här guiden när du börjar koda: hitta resursen du behöver ovan och slå sedan upp de exakta fälten i referensen.

Webhook-resursen

Webhook-referens

Webhook-resursen innehåller konfigurationen för en endpoint: dess URL, vilken API-version den använder och dess signeringsnyckel. Vi rekommenderar att du skapar din första webhook i Billetto under Integrations → Developers och sedan hanterar den via API:et när din lösning växer.

Offentliga evenemang från alla arrangörer

Public Event Search API

Public Event Search API returnerar evenemang som arrangörer har listat offentligt på Billetto, från alla arrangörer. Det passar mediesajter, stadsguider, turistorganisationer och partnerappar som vill visa vad som händer, där varje resultat länkar till Billettos evenemangssida där biljetterna köps.

FAQ OM API OCH WEBHOOKS

Frågor om Billettos API och webhooks

Tekniska frågor från utvecklare som arbetar med Billettos API. Saknar du ett svar? Prata med vårt team.

Var hittar jag min Billetto API-nyckel?

Logga in på Billetto, öppna Integrations och gå till fliken Developers. Under API - Key pairs kan du skapa ett nytt nyckelpar, se vem som äger varje par och återkalla nycklar du inte längre använder.

Vad är skillnaden mellan ett API-nyckelpar och OAuth?

Ett nyckelpar ger dina egna system åtkomst till ditt eget arrangörskonto. OAuth 2.0 är för appar som andra arrangörer kopplar till sitt Billetto-konto, så att du agerar för deras räkning utan att hantera deras inloggning.

Vilka händelser kan Billettos webhooks skicka?

Webhooks täcker ändringar i ordrar, deltagare och evenemang, till exempel nya ordrar, återbetalningar, deltagarändringar och publicerade evenemang. Webhook-referensen listar alla händelser och deras innehåll.

Hur verifierar jag att ett webhook-anrop kommer från Billetto?

Varje webhook har sin egen signeringsnyckel. Använd den för att kontrollera varje inkommande anrop innan du behandlar det, och avvisa anrop som inte klarar kontrollen. Du kan när som helst generera en ny nyckel för en webhook.

Kan jag skapa webhooks via API:et?

Ja. Du kan registrera, uppdatera och ta bort webhooks med webhook-endpoints och generera en ny signeringsnyckel för en befintlig webhook. De flesta team börjar i gränssnittet och går över till API:et när de hanterar flera miljöer.

Vad gör jag om jag får ett HTTP 429-svar?

429 betyder att du skickar för många anrop. Vänta och försök igen med en ökande paus, och använd webhooks i stället för tät polling för att hålla nere antalet anrop.

Kan jag visa Billetto-evenemang på min egen webbplats eller plattform?

Ja. Använd Public Event Search API för evenemang som listas offentligt på Billetto, eller arrangörens events-endpoint för dina egna evenemang. Köparna slutför köpet i Billettos kassa.

Jag är inte utvecklare. Kan jag ändå koppla Billetto till andra verktyg?

Ja. Google Analytics 4, Meta Pixel, Zapier och din egen betalleverantör kopplas in utan kod. Se Billettos integrationer för det du kan sätta upp på några minuter.

Redo för ditt första anrop?

Skapa ett nyckelpar under Integrations, öppna referensen och anropa din första endpoint. Vill du hellre koppla Google Analytics, Meta Pixel eller Zapier utan att skriva kod, börja med Billettos integrationer.