Sportsbook API operaattoreille
Rajapinta, jolla operaattori rakentaa oman urheiluvedonlyöntinsä Nocturn Sportin kertoimien ja vedonvälityksen päälle.
Päivitetty 5. lokakuuta 2026
Sportsbook API on tarkoitettu operaattoreille, jotka haluavat pitää käyttöliittymän omissa käsissään mutta eivät halua rakentaa kerroinlaskentaa ja vedonvälitystä itse. Nocturn Sportin vedonlyönti-API toimittaa ennen ottelua tarjottavat kertoimet, vastaanottaa pelaajien vedot ja pitää kirjaa niiden tilasta. Tällä sivulla kuvataan rajapinnan rakenne pääpiirteittäin.
Kerroinsyöte: tilannekuva ja versioidut muutokset
Ensimmäisellä haulla asiakas saa täyden tilannekuvan kaikista avoimista tapahtumista ja markkinoista. Sen jälkeen syötettä ei tarvitse ladata kokonaan uudelleen: asiakas kysyy muutoksia ilmoittamalla viimeisimmän versionumeronsa, ja palvelin palauttaa vain sen jälkeen tapahtuneet versioidut muutokset (deltat). Suositeltu kyselyväli on noin 10 sekuntia. Näin kaistaa kuluu vähän, ja asiakkaan näkymä pysyy synkronoituna myös katkoksen jälkeen. Syötteen tietorakenne on kuvattu sivulla kerroinsyöte.
Vetojen vastaanotto
- Yksittäis- ja yhdistelmävedot. Yhdistelmässä yksi valinta tapahtumaa kohden, ja kohteiden enimmäismäärä on säädettävissä.
- Pyyntötunnisteet. Jokainen vetopyyntö kantaa yksilöivän request ID:n, joten verkkovirheen jälkeen uudelleenlähetetty pyyntö ei synnytä tuplavetoa.
- Kertoimen tarkistus. Veto hyväksytään vain, jos valittu kerroin on yhä voimassa ja panos mahtuu asetettuihin rajoihin.
Vetohistoria ja saldo
API tarjoaa pelaajakohtaisen vetohistorian (avoimet ja ratkaistut vedot) sekä pelaajan saldon. Näiden avulla operaattori voi näyttää käyttäjälleen "Omat vedot" -näkymän ja täsmäyttää kirjanpidon. Kun integraatio tehdään SoftAggregatorin kautta, lompakko on samassa paketissa kasinopelien kanssa.
Back office -ohjaus
Rajapinnan rinnalla operaattorilla on hallintanäkymä, jossa voi:
- keskeyttää yksittäisen tapahtuman,
- ohittaa minkä tahansa kertoimen käsin,
- ratkaista tuloksia,
- seurata vastuuta tapahtumittain,
- asettaa minimi- ja maksimikertoimen, maksimipanoksen, maksimivoiton, kohteiden enimmäismäärän vetolapulla, sulkemisajan ennen alkua ja marginaalin.
Oletuksena markkinat sulkeutuvat minuutti ennen tapahtuman alkua.
Tyypillinen integraation kulku
- Asiakas hakee tilannekuvan ja tallentaa sen omaan välimuistiinsa.
- Taustaprosessi kysyy muutoksia säännöllisesti ja päivittää tapahtumat, markkinat ja kertoimet.
- Pelaaja valitsee kohteet, ja asiakkaan palvelin lähettää vetopyynnön pyyntötunnisteen kanssa.
- API vahvistaa vedon tai hylkää sen syyn kera (esimerkiksi muuttunut kerroin tai ylittynyt panosraja).
- Tapahtuman päätyttyä veto ratkaistaan, ja saldo sekä vetohistoria päivittyvät.
Tämä rakenne tekee integraatiosta ennustettavan: asiakkaan ei tarvitse pitää yllä pysyvää yhteyttä, eikä yksittäinen katkos johda puuttuviin tietoihin, koska versionumeron avulla kaikki väliin jääneet muutokset saadaan takaisin. Kehittäjälle tämä tarkoittaa yksinkertaista tilanhallintaa ja vähemmän reunatapauksia testattavaksi.
Mitä API ei vielä tee
Live-kertoimia ei toistaiseksi tarjota; ne ovat kehitteillä. Lajivalikoimaa laajennetaan vaiheittain, ja uudet lajit näkyvät samassa syötteessä ilman muutoksia integraatioon.
Markkinat syötteessä
Syöte sisältää ne markkinatyypit, joille malleillamme on tänään hinta. Taulukko kokoaa ne lajeittain:
| Laji | Markkinatyypit syötteessä |
|---|---|
| Jalkapallo | kolmitieveto, yli/alle 1,5–3,5, BTTS, maalitasoitukset |
| Jääkiekko | varsinaisen peliajan kolmitieveto, ottelun voittaja jatkoajan kanssa, maalirajat |
| Koripallo, amerikkalainen jalkapallo | voittaja, pistetasoitus, kokonaispisteet |
| Baseball | voittaja, juoksujen kokonaismäärä |
| Rugby | kolmitieveto, pistetasoitukset |
| Lentopallo | voittaja, erätasoitus ±1,5, erien määrä, lopputulos erinä |
| LoL-e-urheilu | sarjavoittaja, ±1,5 kartan tasoitus, pelattujen karttojen määrä, sarjan lopputulos |
| Tennis, MMA | Elo-pohjainen voittajahinta |
Aloittaminen
Hinnoittelu on pyynnöstä. Tekninen dokumentaatio ja testiympäristö sovitaan yhteydenoton jälkeen. Kirjoita osoitteeseen [email protected], käytä yhteydenottolomakkeen sivua tai laita viesti Telegramiin @mentionso. Jos haluat valmiin käyttöliittymän, katso white label -vaihtoehto tai yleiskuva sportsbook-ohjelmistosta.
Usein kysyttyä
Kuinka usein kerroinsyötettä pitää kysyä?
Noin 10 sekunnin välein. Asiakas lähettää viimeisimmän versionumeronsa ja saa takaisin vain sen jälkeiset muutokset.
Miten tuplavedot estetään verkkovirheen sattuessa?
Jokaisella vetopyynnöllä on yksilöivä pyyntötunniste. Jos sama tunniste lähetetään uudelleen, palvelin tunnistaa sen eikä kirjaa vetoa kahdesti.
Voiko operaattori muuttaa kertoimia itse?
Kyllä. Hallintanäkymässä minkä tahansa kertoimen voi ohittaa käsin, ja marginaali sekä kerroinrajat asetetaan operaattorikohtaisesti.
Paljonko API maksaa?
Hinnat annetaan pyynnöstä. Lähetä kuvaus tarpeistasi osoitteeseen [email protected], niin palaamme asiaan.