Skip to Content

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äätepistePalauttaa
GET /api/v1/meKäyttäjätunnuksesi, nimesi ja sähköpostiosoitteesi
GET /api/v1/toursKiertueet, joihin sinulla on käyttöoikeus
GET /api/v1/tours/:tourId/eventsKiertueen 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.

Last updated on