API-nycklar och Integration API

Med Ticsies Integration API kan ditt eget system hämta evenemang och deltagare och checka in biljetter – server till server. Här ser du hur du skapar ett nyckelpar, vilka behörigheter som finns och vad API:t kan göra. Den fullständiga referensen finns i API-dokumentationen.

Vad kan API:t användas till?

Hämta deltagarlistor till ett eget system, till exempel ett medlemsregister eller ett ackrediteringssystem.
Bygga en egen dashboard över dina evenemang.
Koppla en egen skanner eller grind som checkar in biljetter via API:t.

API:t är till för server-till-server-anrop. Nycklarna får aldrig ligga i en app eller på en webbsida som besökare kan se.

Skapa ett nyckelpar

Öppna API-nycklar. Gå till Inställningar → API-nycklar. Du behöver rollen Ägare eller Admin.
Namnge nyckeln. Under Skapa nytt nyckelpar fyller du i Namn på nyckeln, till exempel ”Medlemsregister” – så vet du senare vad den används till.
Välj behörigheter. Kryssa i read och/eller write (se tabellen nedan).
Generera. Klicka på Generera nyckelpar. Du får en publik nyckel (börjar med ticsie_pk_) och en hemlig nyckel (börjar med ticsie_sk_).
Spara den hemliga nyckeln direkt. Under rubriken Spara din hemliga nyckel nu visas den hemliga nyckeln en enda gång. Klicka på Kopiera och spara den på ett säkert ställe, till exempel i en lösenordshanterare eller som miljövariabel på din server.

Viktigt

Den hemliga nyckeln visas bara en gång och kan inte hämtas igen – Ticsie sparar den inte i klartext. Har du tappat bort den, återkalla nyckelparet och skapa ett nytt.

Behörigheter

Behörighet	I panelen	Ger tillgång till
`read`	Läsa evenemang, ordrar och deltagare	Hämta evenemang och deltagare (GET-anrop).
`write`	Skapa och ändra data via API	Skanna biljetter och checka in deltagare (POST-anrop).

Ge varje nyckel så lite behörighet som möjligt. En nyckel som bara hämtar deltagarlistor behöver bara read.

Anrop, endpoints och begränsningar

Varje anrop skickas till https://ticsie.se/api/v1/integration med två headers:

X-API-Key: ticsie_pk_...
X-API-Secret: ticsie_sk_...

Endpoint	Behörighet	Gör
`GET /events`	read	Lista dina evenemang. Filtrera med `period` = `future`, `past` eller `all`.
`GET /events/{id}/attendees`	read	Lista deltagare (betalda biljetter) för ett evenemang, 50 per sida.
`POST /events/{id}/scan`	write	Checka in en biljett med dess UUID (värdet i biljettens QR-kod).

Gräns: 60 anrop per minut. Överskrids gränsen svarar API:t med HTTP 429 – vänta och försök igen.
Paginering: listor delas upp i sidor. Hämta nästa sida med ?page=2.
Fel returneras som JSON med en error_code, till exempel API_KEY_INVALID eller INSUFFICIENT_PERMISSION.

Exempelanrop i flera språk, svarsformat och alla felkoder finns i API-dokumentationen.

Återkalla en nyckel

I listan under API-nycklar ser du alla nyckelpar med namn, publik nyckel, behörigheter och när de skapades. Klicka på Återkalla och bekräfta med Ja, återkalla. Nyckeln slutar fungera direkt. Återkalla alltid en nyckel som inte används längre eller som kan ha hamnat i fel händer.

Vanliga frågor

Jag har tappat bort den hemliga nyckeln – kan jag få se den igen?

Nej. Den hemliga nyckeln visas bara när nyckelparet skapas. Återkalla det gamla nyckelparet och skapa ett nytt.

Varför får jag felet INSUFFICIENT_PERMISSION?

Nyckeln saknar behörigheten som endpointen kräver. Incheckning via POST /events/{id}/scan kräver write. Skapa ett nytt nyckelpar med rätt behörighet.

Kan jag använda API-nyckeln i en mobilapp eller på min webbplats?

Nej, nycklarna ska bara användas på en server. För incheckning med mobilen finns Ticsie-appen.

Kan jag skapa evenemang eller ordrar via API:t?

Inte i dag. Integration API:t har de tre endpoints som beskrivs ovan. Saknar du något? Lämna ett förslag på Önskemål & roadmap.