Game Launch (Trial)
Get trial game URL, no player registration or real-money account required.
Endpoint
| Property | Value |
|---|---|
| Path | POST /papi/v1/game/launch-trial |
| Auth | Agent Token (Bearer) |
| Content-Type | application/x-www-form-urlencoded |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
game_id | string | Yes | Game ID (from Game List API, uses game_id field) |
currency | string | Yes | Currency code (e.g. MYR, USD). Automatically converted to uppercase |
platform | string | No | Platform type: WEB / MOBILE / DESKTOP, default WEB. Automatically converted to uppercase |
language | string | No | Language code, default en-US |
Request Example
bash
curl -X POST https://api.example.com/papi/v1/game/launch-trial \
-H "Authorization: Bearer {agent_token}" \
-d "game_id=xxxx-guid¤cy=MYR&platform=WEB&language=en-US"Response Fields
| Field | Type | Description |
|---|---|---|
game_url | string | Trial game URL |
Response Example
json
{
"status": true,
"code": 0,
"data": {
"game_url": "https://game.provider.com/trial?token=xxx&lang=en-US"
},
"msg": "success"
}Error Codes
| Code | Message | Description |
|---|---|---|
| 1001 | err.param.invalid | Required parameters missing (game_id, currency) |
| 1002 | err.signature.invalid | Agent Token verification failed |
| 4001 | err.game.not_found | Game not found or offline |
| 4005 | err.game.launch_failed | Game launch failed |
| 5002 | err.provider.call_failed | Game provider API call failed |