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_...| Endpoint | Returnerar |
|---|---|
GET /api/v1/me | Ditt användar-id, namn och e-postadress |
GET /api/v1/tours | Turnéerna du har åtkomst till |
GET /api/v1/tours/:tourId/events | Schemahä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.