Skip to Content

Utvecklar-API

Med TourPros utvecklar-API kan dina egna skript och integrationer läsa din data. Åtkomsten sker via personliga åtkomsttoken: varje token agerar som du och kan endast se de turnéer som du har behörighet att se.

Fas 1 är skrivskyddad: du kan hämta din identitet, dina turnéer och schemahändelser.

Skapa en token

Öppna din profil

Öppna Profile i webbappen och välj fliken Developer.

Skapa token

Klicka på Create token, ge den ett namn (till exempel skriptet eller tjänsten som ska använda den) och bekräfta.

Kopiera den direkt

TourPro visar token en enda gång. Kopiera den och förvara den som ett lösenord. Om du tappar bort den återkallar du token och skapar en ny.

Anropa API:et

Skicka token som en Bearer-autentisering:

Authorization: Bearer tourpro_...
EndpointReturnerar
GET /api/v1/meDitt användar-id, namn och e-postadress
GET /api/v1/toursTurnéerna du har åtkomst till
GET /api/v1/tours/:tourId/eventsSchemahändelser för en turné, filtrerade efter dina behörigheter och synlighetsregler

Bas-URL är API-värden (till exempel https://api.tourpro.app), inte webbappen.

curl https://api.tourpro.app/api/v1/tours \ -H "Authorization: Bearer tourpro_..."

API:et är begränsat till 120 anrop per minut och token. Överskrider du gränsen får du svaret 429 med RateLimit-headers som beskriver tidsfönstret.

Återkalla en token

Tillbaka på fliken Developer klickar du på Revoke bredvid en token och bekräftar. Återkallelsen sker omedelbart och permanent: skapa en ny token om du behöver en ersättare.

Vad en token kan se

En token ser aldrig mer än vad du själv gör:

  • Turnéer: endast turnéer du har skapat eller tillhör.
  • Händelser: endast händelser som är synliga för din roll och dina speldatum på den turnén, och enbart när du har behörighet att visa schemat.
  • Allt är skrivskyddat. Inget i API:et kan ändra din data.

Sessionsinloggningar från appen fungerar inte mot API:et. v1-endpoints accepterar enbart tourpro_-token, så en stulen webbläsarsession kan inte återanvändas mot dem.

Last updated on