Tämä dokumentaatio käsittelee Big Bamboo Slot -kolikkopelin API:n kehittäjille ja järjestelmäkumppaneille. Ohjelmointirajapinta tekee mahdolliseksi pelin integroinnin ja hallinnan ulkoisissa alustoissa. Olemme kehittäneet tämän dokumentin Suomen markkinoiden markkinoiden odotuksiin, ottaen huomioon paikalliset teknologia-standardit, lainsäädännön vaatimukset ja vakiintuneet integraatiokäytännöt. Käyttöön antamamme API pohjautuu REST-arkkitehtuuriin ja soveltaa JSON-muotoista aineistoa, mikä yksinkertaistaa sen käyttöönottoa. Tästä annetusta tekstistä saat tärkeimmät termit, turvallisuusmekanismit, tunnistautumisen ja tavallisimmat käyttötapaukset, jotta kykenet panna alulle liitäntäsi luotettavasti.
Autentikointi ja turva
Suojaus on etusijalla kaikissa tekemisissämme. Tämä liittyy varsinkin Suomen markkinapaikkoja, missä kriteerit ovatkin tiukat. Jokainen tuotantoympäristön API-kyselyt vaativat salatun HTTPS-yhteyden. Autentikointi perustuu JWT (JSON Web Token) -määrittelyyn. Se antaa vankan ja joustavan tavan todentaa kutsujen oikeellisuus. Saat uniikin API-avaimen ja salasanan rekisteröitymisen jälkeen. Näitä tietoja hyödynnetään JWT-tokenin generointiin. Tämä token liitetään seuraavaksi Authorization-otsikkoon kaikissa myöhemmässä API-kyselyssä. Neuvomme vaihtamaan API-salaisuuttasi tietyin väliajoin. Ei koskaan tallennus sitä asiakaspuolen toteutuksessa eikä versionhallinnassa. Kaikki henkilökohtaisia tietoja ja rahaliikennettä koskevat tiedot kryptataan apuna vahvoja salausalgoritmeja tiedonsiirron aikana.
JWT-avainten käyttöönotto
JWT-token on kryptografisesti varmenteettu, ynnä tämä kattaa tarpeelliset tieto (claims) tilistäsi ja hänen valtuuksistaan. Avain on tavallisesti käytettävissä lyhyen aikaa, minkä jälkeen tämä on päivitettävä. Olemme rakentaneet järjestelmän siten, että suojatut, mutta usein säännöllisesti käytetyt toiminnot, kuten pelin tilanne hakeminen, pystyvät käyttää pidempiä voimassaoloaikoja. Maksuliikenteeseen kuuluvat funktiot edellyttävät lyhyitä ynnä useammin päivitettäviä tokeneita. Tämä asia sovittaa yhteen käytettävyyttä ja suojaa. Tarjoamme lisäksi erillisen päätepisteen tokenin päivittämiseen siten, ettei asiakkaan tarvitsee logata sisään uudestaan. On kriittistä, jotta teet tokeneiden hallinnoinnin asiakasohjelmassasi turvallisesti. Vältä kyseisen paljastuminen ulkopuolisille tahoille.
Loppupäätelmät ja seuraavat askeleet
Big Bamboo Slot API antaa Suomen kehittäjille työkalut, joilla luodaan korkealaatuinen ja lakisääteisten vaatimusten mukainen pelikokemus. Aloita rekisteröitymällä kehittäjäportaaliimme. Sieltä käsin saat haltuusi pääsyn täydelliseen API-dokumentaatioon, testiavaimet ja hallintapaneelin integraatiosi tarkkailuun. Neuvomme uhraamaan aikaa testausympäristössämme. Testiympäristössä kykenet tutustumaan kaikkiin toimintoihin ilman vaaroja. Olemme avustamassa sinua koko matkan ajan. Ole rohkeasti kääntyä tekniseen tukeemme, jos kohtaat vaikeuksia tai sinulla on ehdotuksia integraatiosi parantamiseksi. Yhteisvoimin pystymme tuoda Suomen pelaajille varman, nautinnollisen ja moitteettoman pelikokemuksen.
API:n perusrakenteen omaksuminen
Big Bamboo Slot API:n kokoonpano on yksinkertainen. Oliot, kuten pelisessio, käyttäjätiedot ja pelihistoria, ovat saatavilla uniikeilla URI-osoitteillaan. Hyväksytty kutsu antaa HTTP-statuskoodin 200-sarjasta ja vastausaineistoa JSON-muodossa. Virheiden sattuessa palautamme kuvaavat virhetunnukset ja selitteet, jotta kykenet paikantamaan virheen välittömästi. Rajapinta tarjoaa laajennettua hakutoimintoa useille operaatioille, kuten tapahtumahistorialle. Tällä menetelmällä voit kaventaa vastauksia kalenteripäivän, rajan tai toisen ehdon mukaan. Tämä johdonmukainen malli kehittää kehittäjäkokemusta ja alustan huollettavuutta.
Päätepisteet (Endpoints) ja Resurssit
Tärkeimmät päätepisteet kytkeytyvät pelihetken avaamiseen, pelaajan tietojen kyselyyn ja pelien tapahtumien tallentamiseen. Uusi pelihetki tehdään laatimalla POST-pyyntö oikeaan osoitteeseen. Tuloksena saavutat ainutlaatuisen session tunnuksen ja peliin liittymisen tarvitseman URL-osoitteen. Toinen keskeinen päätepiste huolehtii pelaajan saldon synkronoinnista. Kyseinen takaa, että esitettävä saldo on aina tuore eikä käyttäjä ylitä sille määritettyjä rajoja. Kaikissa rahaliikenteeseen koskevissa endpointeissa hyödynnämme idempotenssiavainta. Tämä tunniste ehkäisee identtisen siirron vahingossa tapahtuvan toistolähetyksen, mikä on elintärkeää taloudellisten operaatioiden virheettömyydelle.
Statuskoodit ja Virheidenkäsittely
Olemme kehittäneet selkeän virhehallintajärjestelmän. Jokainen vastaus pitää sisällään lukuarvoisen tilakoodin ja selkokielisen selityksen. Esimerkkinä koodi 400 ilmaisee, että kutsussa oli ongelma, kuten puuttuva vaadittu kenttä. Tunnus 401 merkitsee virheellistä kirjautumista. Suosittelemme toteuttamaan kattavan virheenkäsittelyn asiakaspuolellasi näiden koodien perusteella. Tällä tavoin käyttäjäkokemus pysyy miellyttävänä myös odottamattomissa tilanteissa. Annamme myös päätepisteet ylläpidon aikatauluille ja alustan tilalle. Niiden kautta pystyt aavistaa mahdollisia keskeytyksiä ja tiedottaa asiakkaitasi etukäteen. Tämä avoimuus on tärkeää loppukäyttäjien luottamuksen kehittämisessä.
Optimaaliset käytännöt suorituskyvyn optimoimiseksi

Jotta integraatiosi olisi nopea ja luotettava, noudata muutamia peruskäytäntöä. Suosittelemme toteuttamaan välimuististrategian niille API-kutsuille, jotka eivät sisällä kriittistä reaaliaikadataa. Tällaisia ovat esim. pelin staattiset asetustiedot tai automaattisesti vanhentuvat mainokset. Välimuisti pudottaa tarpeettomia verkkopyyntöjä ja nopeuttaa sivustosi latautumista. Toinen keskeinen tekijä on yhteyksien hallinta. Hyödynnä HTTP-pysyvää yhteystapaa (keep-alive). Se kier tää toistuvan TCP-yhteyden muodostamisen aiheuttaman ylimääräisen kuorman. Vaikka API-mme on suunniteltu kestämään kuormitusta, suunnittele asiakaspuolesi koodi käsittelemään mahdollisia viiveitä tai väliaikaisia virhetilanteita. Tyylikäs tapa on käyttää eksponentiaalista backoff-uudelleenyritysstrategiaa keskeisissä toiminnoissa.
Suorituskyvyn kannalta on viisasta minimoida samanaikaisten API-kutsujen määrä yhdellä sivulla. Sen sijaan, että tekisit useita erillisiä kutsuja pelaajan saldolle, pelitilalle ja kampanjatiedoille, harkitse oman backend-palvelimesi käyttöä. Se voi koostaa nämä tiedot yhdellä kutsulla meiltä ja palvella ne asiakkaallesi yhdistetyssä muodossa. Lopuksi, seuraa aktiivisesti integraatiosi suorituskykyä tuotannossa. Annamme mahdollisuuden saada tilastotietoja API-käytöstäsi kehittäjäportaalissamme. Saatavilla on tietoja kuten pyyntömääriä, keskimääräistä vasteaikaa ja virhemääriä. Näiden tietojen avulla voit nähdä trendejä ennen kuin ne muodostuvat ongelmiksi.
Kehitysympäristö ja kehityksen neuvot
Ennen kuin siirrät integraatiosi tuotantoon, testaa sitä tarkasti omassa testausympäristössämme (sandbox). Tämä ympäristö on kokonaan eristetty tuotannosta. Se toimii pelirahaa, joten voit simuloida kaikkia pelimekaniikkoja ja rahaliikenteen käsittelyä ilman mitään todellisia taloudellisia riskejä. Testiympäristön API-avaimet eroavat tuotantoavaimista. Saat ne rekisteröitymällä kehittäjäportaaliimme. Neuvomme testaamaan etenkin alla olevia skenaarioita: epäonnistunut verkkovastaus keskellä talletuksen, pelaajan yhteyden katkeaminen pelin sattuessa, eri voittotilanteiden hallinta ja maksimibet-rajojen testaus. Tämä edesauttaa varmistamaan, että integraatiosi on vakaa ja tarjoaa turvallisen kokemuksen ongelmatilanteissakin.
- Ota käyttöön lokitusta: Toteuta perusteellinen lokitus kaikista mahdollisista API-kutsuistasi, sekä onnistuneista että epäonnistuneista. Se on korvaamaton apuväline vianetsinnässä.
- Simuloi hidasta verkkoa: Kokeile, kuinka järjestelmäsi käyttäytyy, mikäli API-vastaus viivästyy. Hyödynnä timeout- ja uudelleenyritysmekanismeja.
- Tarkista lakisääteiset vaatimukset: Tee varmaksi, että integraatiosi vastaa kaikki Suomen rahapelilainsäädännön asettamat velvoitteet. Nämä pitävät sisällään ikävähennyksen ja peliongelmaresurssien esilläolon.
- Tee kantatestaus: Pyydä kolmatta osapuolta, kuten kollegaasi, testaamaan integraatiota eri näkökulmasta. He saattavat havaita käytettävyysongelmia, jotka asiat sinulta ovat jääneet huomaamatta.
Olennaiset API-kutsut ja niiden toteutus

Seuraavaksi kerrotaan olennaisimmat API-kutsut, joita tarvitset pelin katkeamattomaan integrointiin. Kukin kutsu edellyttää oikein muodostetun JWT-tunnuksen ja toimitetaan tarkoitukseen päätepisteeseen. Tässä ovat tärkeimmät vaiheet, joilla onnistut pelin toimintaan ympäristössäsi.
- Pelaajan tunnistaminen ja sessio: Ensimmäiseksi tarkistat pelaajan tunnistetiedot ja statuksen järjestelmässämme. Tämä suoritetaan hyödyntäen pelaajan uniikkia tunnistetta.
- Pelisession luominen: Sitten luot tuoreen pelisession, joka yhdistää pelaajan tiettyyn pelikertaan. Saatte vastauksena tuloksena yksilöllisen session tunnuksen.
- Pelin käynnistäminen: Saatuja tietoja käyttäen ohjaat pelaajan suoraan peliin tai näytät pelin iframeen omalle sivustollesi.
- Rahamäärän synkronointi: Kehittäjän on kysyttävä ja päivitettävä pelaajan saldoa toistuvasti reaaliajassa. Hyödynnä tähän dedikoitua päätepistettä.
- Pelin lopputuloksen raportointi: Kun kierros on ohi, ilmoitat lopputuloksen takaisin järjestelmäämme toimintojen kirjaamista varten.
Jokainen mainituista vaiheista on välttämätön. Näiden vaiheiden onnistunut suorittaminen takuulla sen, Big Bamboo Kierrätys Koskee, että pelaaja voi pelata katkotta, hänen rahansa hoidetaan virheettömästi ja jokainen pelitapahtumat ovat läpinäkyviä. Annamme jokaiselle vaiheelle yksityiskohtaiset esimerkkipyynnöt ja -vastaukset kehittäjille tarkoitetussa portaalissa. Kykene testata logiikkaasi porras portaalta niiden avulla. Muista samoin, jos kun pelaaja siirtyy pois pelistä aikana kierroksen, sinun on pystyttävä ohjaamaan hänet alkuperäiseen tilaan. Tämä toimenpide onnistuu tallessa olevan session tunnuksen avulla, kun hän palaa.
Johdanto Big Bamboo Slot -integraatioon
Big Bamboo Slot -integraatio antaa muunneltavat ja suojatut välineet kolikkopelin yhdistämiseksi verkkosivuille, mobiilisovelluksiin tai muihin pelialustoihin. Kaikki toiminnot tapahtuvat standardoitujen HTTP-pyyntöjen, kuten GET, POST ja PUT, kautta. Tämä REST-pohjainen tapa saa aikaan rajapinnasta kieliriippumattoman, ja se toimii useimpien nykyaikaisten ohjelmointikehysten kanssa. Laadimme ratkaisun noudattaen Suomen tiukkoja tietosuoja- ja rahapelilakeja. Tietojen siirrossa sovelletaan salausmenetelmiä, ja pelaajan henkilötiedot käsitellään turvallisesti. Tarjoamme myös täyden testiympäristön (sandbox), jossa voit kehittää ja tarkistaa integraatiota ilman oikeaa rahaliikennettä. Tämä nopeuttaa kehitysvaiheen vianetsintää huomattavasti.
Suomen säädösten huomioon ottaminen
Suomen rahapelilaki (Rahapelilaki 104/2001) antaa tarkkoja velvoitteita kaikille pelitoimijoille. Nämä kohdistuvat suoraviivaisesti API-integraatioon. Yksi oleellisimmista vaatimuksista on ikävähennys. Se varmistaa, että ainoastaan täysi-ikäiset henkilöt voivat pelaamaan. Integraatiosi on kyettävä välittämään pelaajan ikätieto turvallisesti järjestelmäämme ennen pelisession avaamista. Seuraava oleellinen vaatimus liittyy peliongelmaisten suojaa. Järjestelmällämme on tarjottava yksinkertaiset toiminnot peliajan ja tappioiden rajoittamiseen sekä tiedotettava avun saannista. API-mme käsittää rajapinnat, joiden avulla voit tarkastella ja määrittää pelaajan itsensä määrittämiä rajoja. Voit myös esittää nämä rajat pelaajalle alustallasi. Kaikki pelitapahtumat on tallennettava ja saatavissa ainakin 12 kuukauden ajan tilitystä varten.
Myös maksupalveludirektiivi (PSD2) ja vahva asiakastunnistus (SCA) ulottuvat talletus- ja kotiutusprosesseihin. Vaikka nämä prosessit hoidetaan usein maksupalveluntarjoajan kautta, on välttämätöntä, että API-integraatiosi mahdollistaa näiden säädösten vaatimaa turvallisuustasoa. Se edellyttää myös tarpeellista tietojen vaihtoa. Kehotamme tutustumaan Suomen rahapeliviranomaisen, Pelivalvonnan, laatimiin ohjeisiin. Huolehdi, että koko pelikokemuksesi – mihin API-integraatio kuuluu keskeisenä osana – on vaatimusten mukainen. Annamme konsultaatiota parhaista käytännöistä säädösten noudattamiseksi. Ota meihin yhteyttä, jos sinulla on kysyttävää.