跳到主要内容

API 文档简介

欢迎使用VP API 文档。本文档提供两种钱包模式的完整 API 说明。

👉 单一钱包: 查看文档
👉 转账钱包: 查看文档

通用注意事项​

安全性要求​

  1. HTTPS 必须

    • 所有 API 请求必须使用 HTTPS 协议
    • 请确保 SSL 凭证有效且未过期

  2. 加密传输

    • 敏感资料必须使用 AES-256-GCM 加密
    • 请妥善保管加密金钥，避免泄露

  3. 签名验证

    • 每个请求必须包含有效的签名
    • 使用 SHA256 演算法进行签名验证

  4. Token 管理

    • JWT Token 有效期为 1 小时
    • Token 过期后需重新取得
    • 请勿在 URL 中传递 Token

请求规范​

  1. 请求头设定

    Content-Type: application/json
    Authorization: Bearer {token}

  2. 字元编码

    • 统一使用 UTF-8 编码
    • 特殊字元需进行 URL 编码

  3. 时区设定

    • 所有时间参数使用 UTC+0 时区
    • 除标头中的 x-timestamp 使用毫秒 Unix 时间戳以外，其余 API 时间格式需使用 ISO 8601 标准中的 YYYY-MM-DDTHH:mm:ss.SSSZ 格式（例如：2026-02-02T10:30:00.000Z）

  4. 交易时间基准

    • 投注记录查询与报表的交易时间，皆以 txTime（结算时间）为主

  5. 玩家 IP 限制

    • 玩家于游戏过程中的 IP 完全没有限制，游戏中变更 IP 不会影响游玩

错误处理​

  1. 幂等性

    • 使用唯一的「交易ID」、「投注ID」确保幂等性
    • 重复请求不会造成重复扣款

  2. 错误代码

测试环境​

  1. 测试账号

    • 请联系客服团队取得测试环境账号
    • 测试环境与正式环境完全隔离

  2. 测试金钥

    • 测试环境使用独立的 API 金钥
    • 正式上线前需更换为正式环境金钥

  3. 测试数据

    • 测试环境的数据不会同步到正式环境

技术支援​

如在实作过程中遇到问题，请联系客服团队，并附上 Headers 或 Response 中的 UUID 以方便追踪问题

快速开始​

  1. 选择钱包模式 - 根据业务需求选择单一钱包或转账钱包
  2. 取得 API 金钥 - 联系客服团队取得测试环境金钥
  3. 阅读文档 - 详细阅读对应钱包模式的 API 文档
  4. 测试整合 - 在测试环境完成 API 整合
  5. 上线部署 - 申请正式环境后上线部署

额外建议​

萤幕唤醒锁定权限说明 (Screen Wake Lock)​

  • 开启萤幕唤醒锁定，避免装置萤幕自动变暗或关闭「属性定义」当您使用 <iframe> 嵌入服务页面时，必须明确宣告权限策略，否则浏览器会基于安全性理由封锁该功能。
<iframe 
  id="vp-service-monitor" 
  src="https://api.example.com/v1/monitor" 
  allow="screen-wake-lock"
  style="width: 100%; height: 600px; border: none;">
</iframe>