Integration API

သင့် platform ဘက်မှ ခေါ်ရမည့် API များနှင့် request / response နမူနာများ။ Callback များမှာ သင့် server က လက်ခံပြီး ပြန်စာပို့ရမည့် format ဖြစ်သည်။

API	`https://backend.shanboss.com/api/provider/v1`
system_key	`—`
secret_key	`—`
game URL	`—`
callback_url	`—`
balance_url	`—`

MD5 Sign

API တိုင်းတွင် system_key + sign လိုအပ်သည်။

sign မပါသော params ကို key A→Z sort
key=value&key=value string တည်ဆောက်
&secret_key=YOUR_SECRET နောက်ဆက်
MD5 (lowercase hex) → sign

Example

secret_key ကို browser / client ထဲ မထည့်ပါနှင့် — သင့် backend မှသာ sign ထုတ်ပါ။

Launch Game

POST https://backend.shanboss.com/api/provider/v1/launch

Player အတွက် game URL ထုတ်ယူရန် သင့် backend မှ ခေါ်ပါ။

Field	Required	Description
`system_key`	Yes	သင့် provider code
`user_code`	Yes	Player ID (သင့်ဘက်)
`root_id`	Yes	Site / agent ID
`room_id`	No	Room ID
`nickname`	No	Display name
`sign`	Yes	MD5 signature

user_code

root_id

room_id

nickname

Request

Response

Game List

GET POST https://backend.shanboss.com/api/provider/v1/games

Field	Required	Description
`system_key`	Yes	Provider code
`sign`	Yes	MD5 signature

Request

Response

Room List

GET POST https://backend.shanboss.com/api/provider/v1/rooms

Field	Required	Description
`system_key`	Yes	Provider code
`game_id`	No	Default `7106` (Shan Koe Mee)
`sign`	Yes	MD5 signature

game_id

Request

Response

Callbacks — သင့် server က လက်ခံရမည်

Game server က ဒီ provider ရဲ့ callback သို့ POST JSON ပို့သည်။

callback_url: —

balance_url: —

action	Endpoint (သင့်ဘက်)	When
`balance`	`balance_url`	Launch / balance sync
`bet`	`callback_url`	Player net loss / wager
`win`	`callback_url`	Player win (stake + profit)

Sample action

user_code

amount

balance after

round_id

Incoming request (သင့် endpoint သို့)

သင့် response (ပြန်ပေးရမည်)

Sign verify (Node.js)

Betslip & Betslip View

List

GET https://backend.shanboss.com/api/provider/v1/betslip

Field	Required	Description
`system_key`	Yes	Provider code
`user_code`	No	Filter player
`limit`	No	Page size
`sign`	Yes	MD5 signature

user_code

limit

Request

Response

Betslip View URL

GET POST https://backend.shanboss.com/api/provider/v1/betslip-view

Browser ဖွင့်လို့ရသော view_url ရယူရန်။

round_id