> ## 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.

# VA 串接文件（v1）

> v1 遊戲 API 的串接流程、通用規則與各功能入口。

本文件說明 v1 遊戲 API 的串接方式，本頁為 API **v1** 的文件，文件版本為 **v3.4.12**，歷次更新請見[修訂紀錄](https://doc.va777.net/zh-Hant/v1/changelog.md)。

> [!NOTE]
>
> v1 的 API 路徑以 `/api/v1.0/` 為主，少數服務使用 `/api/v2.0/`，請以各 API 頁面標示的路徑為準。新串接建議使用 v2，可從右上角的版本選單切換。

## 串接前準備

1. **提供伺服器 IP**：使用此系統時，請提供呼叫 API 的伺服器 IP。
2. **取得 API 網域、驗證令牌與 API Key**：API 網域 `{host}`、`Authorization` 驗證令牌與產生簽章用的 API Key 皆由我方提供。
3. **確認可用幣別與語系**：幣別請洽詢我方商務；支援語系請參考[語言列表](https://doc.va777.net/zh-Hant/v1/reference/languages.md)。
4. **實作請求格式與簽章**：依[請求與回應格式](https://doc.va777.net/zh-Hant/v1/guides/request-format.md)組裝請求，並依[簽章規則](https://doc.va777.net/zh-Hant/v1/guides/signature.md)產生 `sign`。
5. **單錢包介接商：實作貴司服務**：若採用單錢包，貴司需依[單錢包服務](https://doc.va777.net/zh-Hant/v1/guides/seamless-wallet.md)提供餘額、下注、派彩與取消注單 API。

## 服務功能

> [card] [會員](https://doc.va777.net/zh-Hant/v1/api-reference/member/create.md)
>
> 創建會員、踢除會員、查詢在線遊玩數與遊戲點數。

> [card] [遊戲](https://doc.va777.net/zh-Hant/v1/api-reference/info/game-list.md)
>
> 取得遊戲列表與遊戲連結。

> [card] [錢包](https://doc.va777.net/zh-Hant/v1/api-reference/transaction/deposit.md)
>
> 存款、取款，查詢存取款與點數異動紀錄。

> [card] [注單](https://doc.va777.net/zh-Hant/v1/api-reference/betlog/list-by-time.md)
>
> 取得注單列表、注單詳細資訊與歷史注單。

> [card] [帳務與服務檢查](https://doc.va777.net/zh-Hant/v1/api-reference/report/currency.md)
>
> 幣別報表、會員報表與 API 服務檢查。

> [card] [活動](https://doc.va777.net/zh-Hant/v1/api-reference/info/activity-rank.md)
>
> 活動獎項資訊與免費旋轉活動。

> [card] [背包](https://doc.va777.net/zh-Hant/v1/api-reference/backpack/add-props.md)
>
> 發送與註銷道具。

> [card] [單錢包（貴司提供）](https://doc.va777.net/zh-Hant/v1/guides/seamless-wallet.md)
>
> 由貴司提供、供我方呼叫的錢包 API。


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