Playtomic Club API antaa klubin omistajille mahdollisuuden integroida varausdatan saumattomasti ulkoisiin järjestelmiin, tehostaa toimintaa ja parantaa jäsenten kokemusta. Tämä kattava opas kattaa kaiken, mitä sinun tarvitsee tietää API:mme käyttämisestä ja siihen pääsystä.

Mikä on Playtomic Club API?

Playtomic Club API on turvallinen, vain luku -rajapinta, joka mahdollistaa klubien pääsyn varausdataansa ohjelmallisesti. Riippumatta siitä, hallinnoitko yhtä sijaintia tai useita tiloja, API mahdollistaa:

• Integroinnin olemassa oleviin järjestelmiin kuten CRM:iin, markkinointityökaluihin, kanta-asiakasohjelmiin tai tilanhallintaohjelmistoihin
• Pääsyn reaaliaikaiseen ja historialliseen varausdataan viimeisen 3 kuukauden ajalta
• Datasykronoinnin automatisoinnin klubin toiminnan tehostamiseksi

• Jäsenviestinnän parantamisen ulkoisten työkalujen ja alustojen kautta

   

  📋 Huomio Syltek-klubeille: Voit käyttää API:a samalla datan näkyvyydellä kuin Managerissa. Vaikka varaukset synkronoituvat Syltekistä, huomaa, että kaikki aikatauluelementit (kuten tunnit) eivät välttämättä synkronoidu.

Kuka voi käyttää API:a?

API-pääsy on saatavilla:

• Yhden sijainnin klubeille, joilla on Champion- tai Master-tilaus
• Monisijaintisille klubeille, joissa jokaisella vuokralaisella on Champion- tai Master-tilaus
• Ketjujen omistajille, jotka saavat yhtenäisen pääsyn kaikkiin klubidatoihin organisaatiossaan

Nykyiset API-ominaisuudet

Meidän vain luku -API tarjoaa pääsyn kattavaan varausdataan, mukaan lukien:

• Varaus-ID ja aikaleimat (UTC-muodossa)
• Kenttätiedot (ID, nimi)
• Pelaajatiedot (ID:t, sähköposti, viestintäasetukset)
• Maksutiedot
• Ja paljon muuta (katso täydellinen dataspesifikaatio)

Tulevat ominaisuudet

Laajennamme API:a aktiivisesti:

• Pelaajadatan päätepisteet (sama valtuutus)
• Parannettu pääsy maksuhistoriaan
• Yksityiskohtaiset tapahtuma-, aktiviteetti- ja klinikkatiedot

Ota yhteyttä tilivastaavaasi pyytääksesi tiettyjä ominaisuuksia tai ilmaistaksesi kiinnostuksesi tuleviin mahdollisuuksiin.

Aloittaminen

1. Pyydä pääsyä

1. Ota yhteyttä Playtomic-tilivastaavaasi tai asiakaspalveluun chatin kautta pyytääksesi API-pääsyä
2. Vastaanota tunnuksesi turvallisen linkin kautta (voimassa 3 päivää, enintään 3 avausta)
3. Tallenna tunnukset turvallisesti - väliaikainen linkki vanhenee
4. Pääsy dokumentaatioon ja aloita integrointi

📄 Täydellinen API-dokumentaatio (v1.1)

⚠️ Tärkeää: Tallenna tunnuksesi heti, sillä pääsylinkki vanhenee nopeasti eikä sitä voi helposti luoda uudelleen.

2. Autentikoinnin ymmärtäminen

API käyttää OAuth 2.0 turvalliseen pääsyyn:

Tunnuksesi:

• Asiakas-ID & Asiakassalaisuus: Yksilölliset tunnisteet klubillesi/järjestelmällesi
• Pääsytunnus: Väliaikainen tunnus (yleensä voimassa 1 tunti) API-kutsuille

Tunnuspyynnön esimerkki:

POST <https://api.playtomic.io/oauth/token>
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

API-kutsujen tekeminen:

GET <https://api.playtomic.io/v1/bookings>
Authorization: Bearer your_access_token

🔒 Turvallisuuden parhaat käytännöt:

• Pidä asiakassalaisuus luottamuksellisena
• Älä koskaan paljasta tunnuksia julkisissa arkistoissa
• Toteuta automaattinen tunnuksen uusiminen järjestelmissäsi

Datan spesifikaatiot ja rajoitukset

Aikavyöhykkeen käsittely

• Kaikki aikaleimat ovat UTC-ajassa - varmista, että järjestelmäsi muuntaa paikalliseen aikavyöhykkeeseen
• Varmista klubisi aikavyöhykeasetukset Playtomic Manager > Asetukset > Klubin tiedot

Datan saatavuus

• Historiallinen data: Viimeiset 90 päivää
• Tulevat varaukset: Saatavilla aikataulun mukaisesti
• Maksimipyyntöalue: 365 päivää (90 mennyttä + 275 tulevaa, tai 365 tulevaa)

Nopeusrajoitukset

API-kutsut ovat alttiita nopeusrajoituksille (yleensä 1 kutsu minuutissa) järjestelmän vakauden varmistamiseksi. Tarkista dokumentaatiosta nykyiset rajoitukset.

Yleiset käyttötapaukset

Muunna klubisi toiminta näillä suosituilla integraatioilla:

• CRM-synkronointi: Tuo varausdataa kohdennettuihin markkinointikampanjoihin
• Analytiikka & raportointi: Analysoi kentän käyttöä ja pelaajien käyntitiheyttä
• Jäsenviestintä: Lähetä automaattisia vahvistuksia ja muistutuksia ulkoisten työkalujen kautta
• Tilanhallinta: Integroi älylukkojen, valaistuksen tai muiden IoT-järjestelmien kanssa
• Kanta-asiakasohjelmat: Seuraa jäsenten aktiivisuutta palkitsemis- ja säilyttämisohjelmissa

Vianmääritys & tuki

Avun saaminen

• Tilivastaava: Toteutettavuuden arviointi ja pääsypyynnöt
• Tekninen tuki: API-ongelmien ratkaisu ja integraatioapu
• Dokumentaatio: Täydelliset esimerkit, parametrit ja päätepisteiden kuvaukset

Integraation testaaminen

Vaikka emme tarjoa erillistä testausympäristöä, voit turvallisesti testata todellisilla varausdatoillasi käyttämällä rajoitettuja kyselyitä kehityksen aikana.

Usein kysytyt kysymykset (UKK)

Autentikointi & Pääsy

K: Miten saan API-tunnukset?

V: Ota yhteyttä Playtomic-tilivastaavaasi tai tukitiimiin. Kun pyyntösi on hyväksytty, saat turvallisen linkin (voimassa 3 päivää, enintään 3 avausta), joka sisältää Client ID:n ja Client Secretin.

K: Mitä teen, jos saan "Unauthorized"-virheitä (401/403)?

V: Yleisiä ratkaisuja:

• Varmista, että Authorization: Bearer token otsikko on mukana
• Tarkista, onko pääsytunnuksesi vanhentunut (päivitä tarvittaessa)
• Varmista, että Client ID ja Client Secret ovat oikein

• Varmista, ettet ole ylittänyt nopeusrajoituksia

   

K: Voiko joku muu organisaatiossani pyytää uusia tunnuksia?

V: Kyllä, mutta tärkeää: Uudet tunnuspyynnöt mitätöivät vanhat. Jaa tunnukset organisaatiossasi välttääksesi olemassa olevien integraatioiden häiriöt.

Datan käyttö & Ominaisuudet

K: Voinko luoda tai muokata varauksia API:n kautta?

V: Ei, nykyinen API on vain luku. Voit hakea ja analysoida varausdataa, mutta et voi luoda, päivittää tai poistaa varauksia.

K: Kuinka paljon historiallista dataa voin käyttää?

V: Voit käyttää varausdataa viimeisten 90 päivän ajalta sekä kaikki tulevat varaukset. Maksimipyyntöalue on yhteensä 365 päivää.

K: Missä aikavyöhykkeessä API:n aikaleimat ovat?

V: Kaikki aikaleimat ovat UTC-aikavyöhykkeessä. Integraatiosi on muunnettava nämä paikalliseen aikavyöhykkeeseesi. Varmista, että klubisi aikavyöhyke on oikein asetettu Playtomic Managerissa.

Monipaikkaisuus & Ketjun hallinta

K: Ketjun omistajana, saanko pääsyn kaikkien klubieni dataan?

V: Kyllä! Ketjun omistajat saavat yhtenäisen pääsyn varausdataan kaikissa organisaationsa klubeissa. Voit suodattaa pyyntöjä tiettyihin klubeihin tai hakea dataa kaikista sijainneista.

K: Tarvitsevatko kaikki sijainnit Champion/Master-tilaukset?

V: Kyllä, monipaikkaiseen pääsyyn jokaisella vuokralaisella on oltava Champion- tai Master-tilaus.

Tekninen toteutus

K: Kuinka usein voin kutsua API:a?

V: Nopeusrajoitukset ovat käytössä (tyypillisesti 1 kutsu minuutissa) järjestelmän vakauden varmistamiseksi. Tarkista dokumentaatio nykyisistä rajoituksista ja suunnittele integraatiosi sen mukaisesti.

K: Voinko testata API:a ennen käyttöönottoa?

V: Vaikka erillistä testausympäristöä ei ole, voit turvallisesti testata todellisilla varausdatoillasi käyttämällä rajoitettuja kyselyitä kehityksen aikana.

K: Lisätäänkö API:iin lisää ominaisuuksia?

V: Kyllä! Kehitämme aktiivisesti:

• Pelaajadatan päätepisteitä (sama autentikointi)
• Parannettu maksuhistoria
• Yksityiskohtaiset tapahtuma- ja klinikkatiedot

Ota yhteyttä tilivastaavaasi pyytääksesi tiettyjä ominaisuuksia.

Tuki & Vianmääritys

K: Mitä tietoja minun tulisi antaa pyytäessäni tukea?

V: Sisällytä:

• Täydellinen virheilmoitus
• Kutsumasi päätepiste
• Klubisi ID

• Askeleet, joita olet jo kokeillut

   

K: Keneen minun tulisi ottaa yhteyttä eri tyyppisissä ongelmissa?

V:

• Pyyntöpääsy: Tilivastaava tai asiakaspalvelu chatin kautta pyytääksesi API-pääsyä
• Tekninen integraatio: Tekninen tukitiimi
• Ominaisuuspyynnöt: Tilivastaava
• Laskutus/tilaus: Tilivastaava

Tarvitsetko lisäapua? Ota yhteyttä Playtomic-tilivastaavaasi tai asiakaspalvelutiimiimme saadaksesi henkilökohtaista apua API-integraatiossasi.