Kehittäjä-API
TourPron kehittäjä-API:n avulla omat skriptisi ja integraatiosi voivat lukea TourPro-tietojasi. Pääsy toimii henkilökohtaisilla käyttötunnisteilla (personal access tokens): jokainen tunniste toimii omissa nimissäsi ja näkee vain ne kiertueet, joihin sinullakin on pääsy.
Vaihe 1 on vain luku -tilassa: voit hakea käyttäjätietosi, kiertueesi ja aikataulutapahtumasi.
Luo tunniste
Avaa profiilisi
Avaa verkkosovelluksessa Profiili (Profile) ja valitse Kehittäjä (Developer) -välilehti.
Luo tunniste
Napsauta Luo tunniste (Create token), anna sille kuvaava nimi (esimerkiksi sitä käyttävän skriptin tai palvelun nimi) ja vahvista.
Kopioi tunniste heti
TourPro näyttää tunnisteen vain kerran. Kopioi se heti ja säilytä sitä kuin salasanaa. Jos kadotat tunnisteen, kumoa se ja luo tilalle uusi.
Kutsu API-rajapintaa
Lähetä tunniste Bearer-otsakkeena:
Authorization: Bearer tourpro_...| Päätepiste | Palauttaa |
|---|---|
GET /api/v1/me | Käyttäjätunnuksesi, nimesi ja sähköpostiosoitteesi |
GET /api/v1/tours | Kiertueet, joihin sinulla on käyttöoikeus |
GET /api/v1/tours/:tourId/events | Kiertueen aikataulutapahtumat omien käyttöoikeuksiesi ja näkyvyysasetusten mukaisesti suodatettuna |
Perusosoite on API-palvelin (esimerkiksi https://api.tourpro.app), ei verkkosovellus.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."API:n nopeusrajoitus on 120 pyyntöä minuutissa tunnistetta kohti. Rajan ylittyessä saat vastauksen 429 sekä aikaikkunaa kuvaavat RateLimit-otsakkeet.
Kumoa tunniste
Palaa Kehittäjä (Developer) -välilehdelle, napsauta tunnisteen vieressä Kumoa (Revoke) ja vahvista. Kumoaminen astuu voimaan välittömästi ja on pysyvä: luo tarvittaessa kokonaan uusi tunniste.
Mitä tunniste näkee
Tunniste ei koskaan näe enempää kuin sinä itse:
- Kiertueet: vain kiertueet, jotka olet luonut tai joihin kuulut.
- Tapahtumat: vain roolillesi ja kyseisen kiertueen päiville näkyvät tapahtumat, ja vain silloin kun sinulla on aikataulun katseluoikeus.
- Kaikki on vain luku -tilassa. Mikään API-kutsu ei voi muuttaa tietojasi.
Sovelluksen selainistunnot eivät toimi API-rajapinnassa. v1-päätepisteet hyväksyvät ainoastaan tourpro_-alkuiset tunnisteet, joten kaapattua selainistuntoa ei voi käyttää API-kutsuihin.