OKX登入時提示「驗證碼已過期」如何解決？

時間同步問題

1. OKX要求API請求中的時間戳記與伺服器時間的±30秒以內。不符會觸發「驗證碼過期」錯誤。

2. 開發者必須透過/api/v5/public/time取得目前OKX伺服器時間，並使用該值取代本機系統時間。

3. 即使datetime.utcnow()看起來是同步的，微秒級漂移或時區配置錯誤也可能導致簽章拒絕。

4. 某些 Python 環境預設使用原始日期時間對象，沒有 UTC 時區意識，導致字串格式化期間出現靜默轉換錯誤。

5. ISO 8601 格式必須以Z結尾，且毫秒必須截斷為恰好三位數字，例如2026-05-28T11:24:36.123Z 。

簽章產生錯誤

1. HMAC-SHA256簽章必須嚴格依序連接時間戳記、大寫HTTP方法、請求路徑和正文。

2. 空 JSON 正文必須作為空字串 ( '' ) 傳遞，而不是{}或None ，否則訊息摘要無效。

3. 金鑰必須用作hmac.new()中的第一個參數；顛倒金鑰和訊息的順序會產生不正確的簽章。

4. Base64 編碼必須直接套用於原始摘要字節，而不是十六進位編碼或字串包裝版本。

5. 金鑰或密碼中的任何尾隨空格或不可見的 Unicode 字元都會使簽章默默地失效。

API金鑰配置錯誤

1.具有交易或提現權限的API key需要綁定IP；未綁定的金鑰在 14 天不活動後會自動停用。

2. 在生產域上使用測試網 API 金鑰（反之亦然）會導致身份驗證立即失敗，且沒有明確的錯誤代碼指示環境不符。

3. 密碼區分大小寫並儲存為不可逆的雜湊值；即使輸入錯誤一個字符，也會產生 401 回應，與無效的 API 金鑰無法區分。

4. 原始檔中的硬編碼憑證違反了安全最佳實踐，並且可能在偵錯或版本控制事故期間暴露金鑰。

5. 使用相同 API 金鑰的多次同時登入嘗試可能會觸發驗證端點上的速率限制，暫時阻止有效請求。

網路和路由約束

1. 透過某些代理伺服器或公司防火牆路由的​​請求可能會刪除或變更OK-ACCESS-TIMESTAMP標頭，導致伺服器端進行過期偵測。

2. 負載平衡器或 CDN 有時會快取 REST 端點的回應（即使是那些需要身份驗證的端點），導致過時的時間戳在會話中重複使用。

3. 如果在作業系統層級停用雙棧回退，純 IPv6 網路配置可能無法正確解析 OKX 的 DNS 記錄。

4. 由於過時的密碼套件或憑證固定不符而導致的 TLS 握手失敗會阻止標頭完全到達身份驗證層。

5. 基於地理位置的路由可能會將請求定向到區域端點（例如 myokx.com），該端點執行比全球 api.okx.com 網域更嚴格的驗證規則。

常見問題解答

Q：為什麼我在 60 秒內輸入了驗證碼，OKX 卻拒絕了我的驗證碼？答：拒絕與使用者輸入時間無關－它反映了伺服器端簽章驗證失敗。 「過期」標籤是指簽署請求內的時間戳記參數，而不是 SMS 代碼生命週期。

Q：我可以在多個請求中重複使用相同的時間戳記嗎？答：不可以。每個請求必須攜帶唯一的、單調遞增的時間戳記。重複使用值會觸發防重播保護並傳回錯誤代碼10000 。

Q：啟用雙重認證是否會影響 API 登入流程？答：是的。 TOTP 或硬體金鑰註冊完全停用基於 SMS 的 API 存取驗證。僅接受 API 金鑰 + 密碼 + 簽章請求。

Q：有沒有辦法在不提交即時請求的情況下驗證我的簽名邏輯？答：是的。 OKX 提供了一個公開測試端點/api/v5/public/time ，它接受未簽署的 GET 請求。在簽署專用端點之前，使用它來確認基本連接和時間對齊。