跳至主要内容

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