Udvikler-API
TourPros udvikler-API giver dine egne scripts og integrationer mulighed for at læse dine data. Adgangen fungerer via personlige adgangstokens: hvert token optræder på dine vegne og kan kun se de tours, som du selv kan se.
Fase 1 er skrivebeskyttet: du kan hente din identitet, dine tours og kalenderbegivenheder.
Opret et token
Åbn din profil
Åbn din Profile i webapp’en, og vælg fanen Developer.
Opret tokenet
Klik på Create token, giv det et navn (for eksempel det script eller den tjeneste, der skal bruge det), og bekræft.
Kopiér det med det samme
TourPro viser kun tokenet én gang. Kopiér det, og opbevar det som en adgangskode. Hvis du mister det, skal du tilbagekalde tokenet og oprette et nyt.
Kald API’et
Send tokenet som en Bearer-legitimation:
Authorization: Bearer tourpro_...| Endpoint | Returnerer |
|---|---|
GET /api/v1/me | Dit bruger-id, navn og e-mail |
GET /api/v1/tours | De tours, du har adgang til |
GET /api/v1/tours/:tourId/events | Kalenderbegivenheder for en tour, filtreret efter dine tilladelser og synlighed |
Basis-URL er API-værten (for eksempel https://api.tourpro.app), ikke webapp’en.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."API’et er begrænset til 120 forespørgsler pr. minut pr. token. Overstiger du grænsen, får du et 429-svar med RateLimit-headere, der beskriver tidsvinduet.
Tilbagekald et token
Tilbage på fanen Developer klikker du på Revoke ud for et token og bekræfter. Tilbagekaldelsen sker øjeblikkeligt og permanent: opret et nyt token, hvis du har brug for en erstatning.
Hvad et token kan se
Et token kan aldrig se mere end dig:
- Tours: kun tours, du har oprettet eller er med på.
- Begivenheder: kun begivenheder, der er synlige for din rolle og dine spilledatoer på touren, og kun når du har tilladelse til at se kalenderen.
- Alt er skrivebeskyttet. Intet i API’et kan ændre dine data.
Sessionslogins fra appen fungerer ikke mod API’et. v1-endpoints accepterer kun tourpro_-tokens, så en stjålet browsersession kan ikke genbruges imod dem.