> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 取得遊戲連結

> [!NOTE]
>
> * 遊戲連結有效時間為300秒，超過有效時間未登入該連結即失效無法使用。
> * 遊戲僅允許會員單開視窗遊玩。
> * 若app參數傳入Y，我方會將遊戲中詳單列表按鈕移除，若貴司有查看詳單需求，可以透過[4.2 取得注單詳細資訊](https://doc.va777.net/api-reference/betlog/detail.md)取得詳單。
> * 遊戲編號帶入0，取得遊戲大廳連結，其他請帶入遊戲編號。

## 請求參數

**channelID** `number` *required*

渠道編號 (若無渠道，請帶入1)

**account** `string` *required*

會員帳號 (允許字元:`a-z A-Z 0-9 _-`)

**currency** `string` *required*

幣別 (請洽詢我方商務)

**gameID** `number` *required*

遊戲編號 (0:遊戲大廳，非0:遊戲編號)

**gamePlat** `string` *required*

遊戲開啟平台 (請填入 web 或 mobile)

**app** `string` *required*

透過app開啟 (Y:將隱藏遊戲紀錄功能 N:不隱藏)

**lang** `string` *required*

遊戲語系 (請洽詢我方商務)

**clientIP** `string` *required*

玩家IP

**url** `string`

返回網址 (需以[http://或https://開頭](http://或https://開頭))

**muteMusic** `boolean`

關閉音樂 (true:關閉、false:不關閉，預設false)

**muteSound** `boolean`

關閉音效 (true:關閉、false:不關閉，預設false)

**sign** `string` *required*

簽章，產生方式請參考[簽章規則](https://doc.va777.net/guides/signature.md)

## 回應

成功（HTTP 狀態碼固定為 200，請以 `status.code` 判斷結果）

**data** `object`

**屬性**

**url** `string`

遊戲連結

**token** `string`

此次遊戲令牌

**status** `object`

每次回應都會附帶的請求處理狀態

**屬性**

**code** `string`

回應訊息碼，請參照[回應訊息碼](https://doc.va777.net/reference/response-codes.md)

**message** `string`

回應詳細訊息

**datetime** `string`

請求接收時間，格式為 RFC3339

**traceCode** `string`

回應追蹤碼（唯一值），供雙方比對回應內容

```json 200 theme={null}
{
  "data": {
    "url": "http://xxx-xx.xxxx/xxxx.xxxx?xx=xxxxxxxxx",
    "token": "35f990b7adda4cb9a25601cf6bf690bd"
  },
  "status": {
    "code": "0",
    "message": "success",
    "datetime": "2022-07-01T10:13:54.920+08:00",
    "traceCode": "7cf25e1957cc47fe8e01f1a7c6d504d6"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.