跳到主要内容

API 文档簡介

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

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

通用注意事项​

安全性要求​

  1. HTTPS 必须

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

  2. 加密传输

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

  3. 签名验证

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

  4. Token 管理

    • JWT Token 有效期为 24 小时
    • 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）

错误处理​

  1. 冪等性

    • 使用唯一的交易 ID 确保冪等性
    • 重复请求不会造成重复扣款

  2. 错误代码

测试环境​

  1. 测试账号
  • 请聯繫技术支援取得测试环境账号
  • 测试环境与正式环境完全隔离
  1. 测试金鑰
  • 测试环境使用獨立的 API 金鑰
  • 正式上线前需更换为正式环境金鑰
  1. 测试数据
  • 测试环境的数据不会同步到正式环境

技术支援​

如在实作过程中遇到问题,请聯繫 TG 技术支援团队

快速开始​

  1. 选择钱包模式 - 根据业务需求选择单一钱包或转账钱包
  2. 取得 API 金鑰 - 聯繫技术支援取得测试环境金鑰
  3. 阅读文档 - 详细阅读对应钱包模式的 API 文档
  4. 测试整合 - 在测试环境完成 API 整合
  5. 上线部署 - 申请正式环境后上线部署

最后更新: 2026-02-02