Billetto API-dokumentation och webhooks-guide
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
- Kom igång-guide: skapa inloggningsuppgifter och gör ditt första anrop
- API-referens: alla endpoints, parametrar och svarsobjekt
- Webhook-referens: webhook-resursen och dess fält
- Public Event Search: hämta offentligt tillgängliga evenemang på Billetto
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
- Ordrar och deltagare
- Ekonomi och rapporter
- Audiences
- Webhooks
- Offentliga evenemang
Evenemang och biljettyper
Hämta evenemangen på ditt konto med datum, platser, status och biljettyper.
GET /organiser/eventslistar 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/orderslistar ordrar för alla dina evenemangGET /organiser/events/{event_id}/attendeeslistar 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_entrieslistar 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/webhooksregistrerar 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
Integrations
Example dataAPI - Key pairs
+ Create key pairAUDIENCESSteg 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
Audiences
Example dataVIP members 2026Synced via API
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
Integrations
Example dataWebhooks
Receive data based on specific webhook events
Recent deliveriesLive
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å levereras en Billetto-webhook
Från det ögonblick en biljett säljs tills ditt system har behandlat den.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
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-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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Denmark