{"id":3139,"date":"2026-06-16T02:25:05","date_gmt":"2026-06-16T02:25:05","guid":{"rendered":"https:\/\/scohen.co.il\/?p=3139"},"modified":"2026-07-12T03:24:32","modified_gmt":"2026-07-12T03:24:32","slug":"big-bamboo-peliautomaatti-api-dokumentaatio-suomen-kehittaejaeyhteisoen-kehittaejille","status":"publish","type":"post","link":"https:\/\/scohen.co.il\/en\/big-bamboo-peliautomaatti-api-dokumentaatio-suomen-kehittaejaeyhteisoen-kehittaejille\/","title":{"rendered":"Big Bamboo-peliautomaatti API-dokumentaatio Suomen kehitt\u00e4j\u00e4yhteis\u00f6n kehitt\u00e4jille"},"content":{"rendered":"
\n\"Game<\/p>\n

T\u00e4m\u00e4 kyseinen dokumentaatio k\u00e4sittelee Big Bamboo Slot -kolikkopelin API:n ohjelmoijille ja teknologia-kumppaneille. API tekee mahdolliseksi pelin upottamisen ja hallinnan ulkoisissa alustoissa. Olemme laatineet t\u00e4m\u00e4n oppaan Suomen markkinoiden vaatimuksiin, painottaen kansalliset j\u00e4rjestelm\u00e4standardit, s\u00e4\u00e4d\u00f6svaatimukset ja vakiintuneet integraatiok\u00e4yt\u00e4nn\u00f6t. Tarjoamamme API rakentuu REST-arkkitehtuuriin ja soveltaa JSON-muotoista aineistoa, mik\u00e4 helpottaa sen implementointia. T\u00e4st\u00e4 kyseisest\u00e4 tekstist\u00e4 l\u00f6yd\u00e4t t\u00e4rkeimm\u00e4t m\u00e4\u00e4ritelm\u00e4t, suojausmekanismit, todentamisen ja tavallisimmat skenaariot, jotta pystyt panna alulle liit\u00e4nt\u00e4si turvallisesti.<\/p>\n

Johdanto Big Bamboo Slot -rajapintaan<\/h2>\n

Big Bamboo Slot -liittym\u00e4 tuo muunneltavat ja varmat apuv\u00e4lineet kolikkopelin kytkemiseksi verkkosivuille, mobiilisovelluksiin tai muihin pelialustoihin. Kaikki tapahtumat tapahtuvat standardoitujen HTTP-pyynt\u00f6jen, kuten GET, POST ja PUT, kautta. T\u00e4m\u00e4 REST-pohjainen tapa tekee rajapinnasta kieliriippumattoman, ja se sopii yhteen useimpien nykyaikaisten ohjelmointikehysten kanssa. Laadimme ratkaisun noudattaen Suomen tiukkoja tietosuoja- ja rahapelilakeja. Tietojen siirrossa hy\u00f6dynnet\u00e4\u00e4n salausmenetelmi\u00e4, ja pelaajan henkil\u00f6tiedot k\u00e4sitell\u00e4\u00e4n turvallisesti. Toimitamme my\u00f6s t\u00e4yden testiymp\u00e4rist\u00f6n (sandbox), jossa voit kehitt\u00e4\u00e4 ja tarkistaa integraatiota ilman oikeaa rahaliikennett\u00e4. T\u00e4m\u00e4 nopeuttaa kehitysvaiheen vianetsint\u00e4\u00e4 huomattavasti.<\/p>\n

Varmennus ja turvallisuus<\/h2>\n

Turva on etusijalla kaikissa toiminnassamme. T\u00e4m\u00e4 koskee etenkin Suomen markkinapaikkoja, miss\u00e4 kriteerit olevat tiukat. Kaiken tuotantoymp\u00e4rist\u00f6n API-kyselyt edellytt\u00e4v\u00e4t salatun HTTPS-liittym\u00e4n. Autentikointi pohjautuu JWT (JSON Web Token) -standardiin. T\u00e4m\u00e4 j\u00e4rjestelm\u00e4 mahdollistaa vankan ja skaalautuvan tavan todentaa kyselyjen aitous. Saat henkil\u00f6kohtaisen API-avaimen ynn\u00e4 salausavaimen rekister\u00f6innin p\u00e4\u00e4ttyess\u00e4. N\u00e4it\u00e4 tietoja k\u00e4ytet\u00e4\u00e4n JWT-avaimen generointiin. T\u00e4m\u00e4 tunnus lis\u00e4t\u00e4\u00e4n sitten Authorization-kentt\u00e4\u00e4n kaikissa tulevassa API-kyselyss\u00e4. Neuvomme uudistamaan API-salasanaasi s\u00e4\u00e4nn\u00f6llisin v\u00e4liajoin. \u00c4l\u00e4 milloinkaan s\u00e4ilyt\u00e4 sit\u00e4 selaimen koodissa tai Git-varastossa. Kaikki henkil\u00f6kohtaisia tietoja ynn\u00e4 rahaliikennett\u00e4 k\u00e4sitt\u00e4v\u00e4t tiedot suojataan hy\u00f6dynt\u00e4en voimakkaita algoritmeja tiedonsiirron ajalla.<\/p>\n

JWT-tunnusten soveltaminen<\/h3>\n

JWT-tunnus on s\u00e4hk\u00f6isesti signeerattu, ynn\u00e4 joka kattaa tarpeelliset tieto (claims) tilist\u00e4si sek\u00e4 h\u00e4nen oikeustoimistaan. Avain on tavallisesti aktiivinen m\u00e4\u00e4r\u00e4aikaisen aikaa, mink\u00e4 j\u00e4lkeen t\u00e4m\u00e4 t\u00e4ytyy uusia. Olemme toteuttaneet alustan niin, ett\u00e4 turvalliset, kuitenkin useasti kutsuttavat toiminnot, esimerkiksi pelitilanteen haku, pystyv\u00e4t k\u00e4ytt\u00e4\u00e4 pidempi\u00e4 voimassaoloaikoja. Rahaliikenteeseen kuuluvat funktiot vaativat lyhyempi\u00e4 ja toistuvammin uusittavia tokeneita. T\u00e4m\u00e4 malli sovittaa yhteen helppok\u00e4ytt\u00f6isyytt\u00e4 sek\u00e4 turvallisuutta. Annamme my\u00f6s oman p\u00e4\u00e4tepisteen tokenin uudistamiseen niin, ettei k\u00e4ytt\u00e4j\u00e4n on pakko logata sis\u00e4\u00e4n kerran uudestaan. On kriittist\u00e4, niin ett\u00e4 suoritat tokenin hallinnan asiakaspuolellasi turvallisella tavalla. Est\u00e4 kyseisen tiedon vuotaminen kolmansille tahoille.<\/p>\n

Rajapinnan perusrakenteen hahmottaminen<\/h2>\n

Big Bamboo Slot API:n rakenne on yksinkertainen. Oliot, kuten pelisessio, pelaajien tiedot ja pelien historia, ovat tarjolla omilla URI-osoitteillaan. Onnistunut pyynt\u00f6 palauttaa HTTP-statuskoodin 200-sarjasta ja vastausaineistoa JSON-muodossa. Virheiden sattuessa toimitamme selitt\u00e4v\u00e4t virhetunnukset ja viestit, jotta pystyt tunnistamaan ongelman pikaisesti. Rajapinta mahdollistaa monipuolista hakutoimintoa lukuisille teht\u00e4ville, kuten tapahtumahistorialle. T\u00e4m\u00e4n tavalla pystyt kaventaa vastauksia aikam\u00e4\u00e4r\u00e4n, rajan tai jonkin kriteerin mukaan. T\u00e4m\u00e4 yhten\u00e4inen malli parantaa kehitt\u00e4j\u00e4kokemusta ja alustan yll\u00e4pitoa.<\/p>\n

P\u00e4\u00e4tepisteet (Endpoints) ja Oliot<\/h3>\n

Keskeisimm\u00e4t endpointit kytkeytyv\u00e4t pelisession k\u00e4ynnist\u00e4miseen, pelaajan tietojen kyselyyn ja peliaktiviteettien merkitsemiseen. Uusi pelikerta muodostetaan laatimalla POST-pyynt\u00f6 asianmukaiseen osoitteeseen. Tuloksena saavutat uniikin session tunnuksen ja peliin yhdistymisen edellytt\u00e4m\u00e4n URL-osoitteen. Toinen olennainen p\u00e4\u00e4tepiste hoitaa pelaajan saldon synkronoinnista. T\u00e4m\u00e4 takaa, ett\u00e4 esitett\u00e4v\u00e4 saldo on jatkuvasti ajantasainen eik\u00e4 k\u00e4ytt\u00e4j\u00e4 ylit\u00e4 sille m\u00e4\u00e4ritettyj\u00e4 kattoja. Kaikissa maksuliikenteeseen koskevissa p\u00e4\u00e4tepisteiss\u00e4 sovellamme toistotunnistetta. T\u00e4m\u00e4 avain est\u00e4\u00e4 saman transaktion vahingollisen toistol\u00e4hetyksen, mik\u00e4 on t\u00e4rke\u00e4\u00e4 rahaan liittyvien toimenpiteiden virheett\u00f6myydelle.<\/p>\n

Statuskoodit ja Virheenk\u00e4sittely<\/h3>\n

Me olemme luoneet ymm\u00e4rrett\u00e4v\u00e4n virheenk\u00e4sittelyj\u00e4rjestelm\u00e4n. Kukin palautus k\u00e4sitt\u00e4\u00e4 numeerisen statuskoodin ja ihmisluettavan selityksen. Esimerkkin\u00e4 koodi 400 ilmaisee, ett\u00e4 kutsussa oli vika, kuten puuttuva vaadittu kentt\u00e4. Tunnus 401 tarkoittaa virheellist\u00e4 autentikointia. Kehotamme tekem\u00e4\u00e4n laajan virheenk\u00e4sittelyn asiakaspuolellasi n\u00e4iden koodien perusteella. T\u00e4ll\u00e4 tavoin k\u00e4ytt\u00e4j\u00e4kokemus pysyy hyv\u00e4n\u00e4 my\u00f6s odottamattomissa tapauksissa. Tarjoamme my\u00f6s p\u00e4\u00e4tepisteet huollon aikatauluille ja alustan tilalle. N\u00e4iden avulla pystyt aavistaa potentiaalisia katkoksia ja informoida k\u00e4ytt\u00e4ji\u00e4si ennakkoon. T\u00e4m\u00e4 l\u00e4pin\u00e4kyvyys on t\u00e4rke\u00e4\u00e4 lopullisten k\u00e4ytt\u00e4jien uskollisuuden kehitt\u00e4misess\u00e4.<\/p>\n

Olennaiset API-kutsut ja niiden toteutustapa<\/h2>\n

T\u00e4ss\u00e4 kerrotaan olennaisimmat API-kutsut, jotka tarvitaan pelin saumattomaan integrointiin. Jokainen kutsu tarvitsee oikealla tavalla muodostetun JWT-tunnuksen ja toimitetaan osoitettuun p\u00e4\u00e4tepisteeseen. T\u00e4ss\u00e4 ovat keskeisimm\u00e4t vaiheet, joiden kautta saat pelin toimivaksi ymp\u00e4rist\u00f6ss\u00e4si.<\/p>\n

    \n
  1. Pelaajien tunnistaminen ja sessio<\/strong>: Ensimm\u00e4iseksi todennat pelaajan identiteetin ja statuksen j\u00e4rjestelm\u00e4ss\u00e4mme. T\u00e4m\u00e4 suoritetaan hy\u00f6dynt\u00e4en pelaajan ainutlaatuista tunnistetta.<\/li>\n
  2. Pelisession luominen<\/strong>: Sitten teet tuoreen pelisession, joka pelaajan tarkkaan pelikertaan. Saat palautteena uniikin session tunnuksen.<\/li>\n
  3. Pelaamisen k\u00e4ynnist\u00e4minen<\/strong>: Vastaanotettuja tietoja k\u00e4ytt\u00e4en johdat pelaajan v\u00e4litt\u00f6m\u00e4sti peliin tai avaat pelin iframeen oman sivustollesi.<\/li>\n
  4. Tilin synkronointi<\/strong>: Kehitt\u00e4j\u00e4n on haettava ja muutettava pelaajan saldoa toistuvasti reaaliajassa. Hy\u00f6dynn\u00e4 t\u00e4ss\u00e4 erillist\u00e4 p\u00e4\u00e4tepistett\u00e4.<\/li>\n
  5. Pelin lopputuloksen raportointi<\/strong>: Kun kierros on ohi, ilmoitat lopputuloksen palautteena j\u00e4rjestelm\u00e4\u00e4mme pelitapahtumien kirjaamista varten.<\/li>\n<\/ol>\n

    Joka n\u00e4ist\u00e4 vaiheista on v\u00e4ltt\u00e4m\u00e4t\u00f6n. N\u00e4iden vaiheiden onnistunut suorittaminen varmistaa sen, ett\u00e4 pelaaja kykenee pelata katkotta, h\u00e4nen rahansa k\u00e4sitell\u00e4\u00e4n oikein ja jokainen pelitapahtumat ovat avoimia. Annamme kaikille vaiheelle yksityiskohtaiset esimerkkipyynn\u00f6t ja -vastaukset kehitt\u00e4j\u00e4portaalissa. Pystyt testata p\u00e4\u00e4ttely\u00e4si askel askeleelta niiden avulla. Huomioi my\u00f6s, jos kun pelaaja siirtyy pois pelist\u00e4 keskell\u00e4 kierroksen, kehitt\u00e4j\u00e4n on pystytt\u00e4v\u00e4 siirt\u00e4m\u00e4\u00e4n h\u00e4net entiseen tilaan. T\u00e4m\u00e4 toimii s\u00e4il\u00f6tyn session tunnuksen avulla, kun h\u00e4n h\u00e4n palaa.<\/p>\n

    Suomen lakien huomioon ottaminen<\/h2>\n

    Suomen rahapelilaki (Rahapelilaki 104\/2001) antaa tarkkoja vaatimuksia kaikenlaisille pelitoimijoille. N\u00e4m\u00e4 vaikuttavat v\u00e4litt\u00f6m\u00e4sti API-integraatioon. Yksi oleellisimmista vaatimuksista on i\u00e4n tarkistus. Se varmistaa, ett\u00e4 vain 18 vuotta t\u00e4ytt\u00e4neet henkil\u00f6t voivat pelaamaan. J\u00e4rjestelm\u00e4si on osattava siirt\u00e4m\u00e4\u00e4n pelaajan ik\u00e4tieto varmasti alustallemme ennen pelisession avaamista. Toinen merkitt\u00e4v\u00e4 vaatimus kohdistuu peliongelmaisten suojaa. J\u00e4rjestelm\u00e4ll\u00e4mme on annettava helppok\u00e4ytt\u00f6iset ty\u00f6kalut peliajan ja tappioiden rajoittamiseen sek\u00e4 kerrottava avun saannista. API-mme k\u00e4sitt\u00e4\u00e4 rajapinnat, joiden avulla voit hakea ja asettaa pelaajan itsens\u00e4 valitsemia rajoja. Voit my\u00f6s esitt\u00e4\u00e4 n\u00e4m\u00e4 rajat pelaajalle ymp\u00e4rist\u00f6ss\u00e4si. Joka ainoa pelitapahtumat on s\u00e4ilytett\u00e4v\u00e4 ja n\u00e4ht\u00e4vill\u00e4 v\u00e4hint\u00e4\u00e4n 12 kuukauden ajan tilityst\u00e4 varten.<\/p>\n

    Lis\u00e4ksi maksupalveludirektiivi (PSD2) ja vahva asiakastunnistus (SCA) vaikuttavat talletus- ja kotiutusprosesseihin. Ehk\u00e4 n\u00e4m\u00e4 prosessit suoritetaan usein maksupalveluntarjoajan kautta, on oleellista, ett\u00e4 API-integraatiosi mahdollistaa n\u00e4iden s\u00e4\u00e4d\u00f6sten vaatimaa turvallisuustasoa. Se vaatii my\u00f6s tarvittavaa tietojen vaihtoa. Suosittelemme tutustumaan Suomen rahapeliviranomaisen, Pelivalvonnan, antamiin ohjeisiin. Varmista, ett\u00e4 koko pelikokemuksesi \u2013 mihin API-integraatio liittyy oleellisena osana \u2013 on vaatimusten mukaisesti toteutettu. Tarjoamme konsultaatiota parhaista k\u00e4yt\u00e4nn\u00f6ist\u00e4 s\u00e4\u00e4d\u00f6sten noudattamiseksi. K\u00e4\u00e4nny meihin yhteytt\u00e4, jos sinulla on kysytt\u00e4v\u00e4\u00e4.<\/p>\n

    Testausymp\u00e4rist\u00f6 ja kehitysvaiheen ohjeet<\/h2>\n

    Ennen kuin siirr\u00e4t integraatiosi tuotantoon, tarkista sit\u00e4 huolellisesti tarkoitukseen varatussa testausymp\u00e4rist\u00f6ss\u00e4mme (sandbox) bigbamboo.fi<\/a>. T\u00e4m\u00e4 ymp\u00e4rist\u00f6 on kokonaan eristetty tuotannosta. Se toimii pelirahaa, joten voit simuloida eri pelimekaniikkoja ja rahaliikenteen k\u00e4sittely\u00e4 ilman todellisia taloudellisia riskej\u00e4. Testiymp\u00e4rist\u00f6n API-avaimet poikkeavat tuotantoavaimista. Saat ne rekister\u00f6itym\u00e4ll\u00e4 kehitt\u00e4j\u00e4portaaliimme. Neuvomme testaamaan varsinkin alla olevia skenaarioita: ep\u00e4onnistunut verkkovastaus kesken talletuksen, pelaajan yhteyden katkeaminen pelin sattuessa, eri voittotilanteiden k\u00e4sittely ja maksimibet-rajojen kokeilu. T\u00e4m\u00e4 edesauttaa varmistamaan, ett\u00e4 integraatiosi on luotettava ja tuottaa turvallisen kokemuksen h\u00e4iri\u00f6tilanteissakin.<\/p>\n