簽署挑戰（WebSocket API）

最近一次更新： 2026年10月7日

向 WebSocket 私有訂閱源發送訂閱及取消訂閱請求時，需要附上以客戶 api_secret 簽署的挑戰
訊息。

挑戰的取得方式請參閱 WebSocket API Public 一節（使用 api_key）。

已驗證的請求必須以 JSON 格式同時包含原始挑戰訊息（original_challenge）及已簽署的挑戰（signed_challenge）。

挑戰賽

挑戰為 UUID 字串。

範例：c100b894-1729-464d-ace1-52dbce11db42 


簽署挑戰的步驟與產生已驗證 REST 請求的步驟相同，
唯步驟 1 改為直接使用挑戰字串：

  1. 1

    使用 SHA-256 演算法對挑戰進行哈希處理

  2. 2

    Base64解碼您的api_secret

  3. 3

    使用步驟 2 的結果，以 HMAC-SHA-512 演算法對步驟 1 的結果進行哈希處理

  4. 4

    將步驟 3 的結果進行 Base64 編碼

步驟 4 的結果即為已簽署的挑戰，將包含於訂閱請求中。

下表為範例輸入的預期輸出結果：

挑戰

c100b894-1729-464d-ace1-52dbce11db42

api_secret

 7zxMEF5p/Z8l2p2U7Ghv6x14Af+Fx+92tPgUdVQ748FOIrEoT9bgT+bTRfXc5pz8na+hL/QdrCVG7bh9KpT0eMTm

已簽署輸出

4JEpF3ix66GA2B+ooK128Ift4XQVtc137N9yeg4Kqsn9PI0Kpzbysl9M1IeCEdjg0zl00wkVqcsnG4bm
nlMb3A==