OKX にログインするときに「検証コードの有効期限が切れました」というメッセージを修正するにはどうすればよいですか?

時刻同期の問題

1. OKX では、API リクエストのタイムスタンプがサーバー時間の±30 秒以内である必要があります。不一致があると、「検証コードの有効期限が切れました」エラーが発生します。

2. 開発者は、 /api/v5/public/time経由で現在の OKX サーバー時刻を取得し、ローカル システム時刻の代わりにその値を使用する必要があります。

3. datetime.utcnow()が同期しているように見えても、マイクロ秒レベルのずれやタイムゾーンの設定ミスにより署名が拒否される可能性があります。

4. 一部の Python 環境では、デフォルトで UTC タイムゾーンを認識しない単純な日時オブジェクトが使用されるため、文字列の書式設定中にサイレント変換エラーが発生します。

5. ISO 8601 形式はZで終わる必要があり、ミリ秒は正確に 3 桁に切り捨てる必要があります (例: 2026-05-28T11:24:36.123Z )。

署名生成エラー

1. HMAC-SHA256 署名は、タイムスタンプ、大文字の HTTP メソッド、リクエスト パス、および本文を厳密な順序で連結する必要があります。

2. 空の JSON 本文は、 {}やNoneではなく、空の文字列 ( '' ) として渡す必要があります。そうしないと、メッセージ ダイジェストが無効になります。

3. 秘密キーはhmac.new()の最初の引数として使用する必要があります。キーとメッセージの順序を逆にすると、不正な署名が生成されます。

4. Base64 エンコードは、16 進エンコードまたは文字列でラップされたバージョンではなく、生のダイジェスト バイトに直接適用する必要があります。

5. 秘密キーまたはパスフレーズの末尾の空白文字または非表示の Unicode 文字は、サイレントに署名を無効にします。

API キー設定の間違い

1. 取引または出金の権限を持つ API キーには IP バインドが必要です。バインドされていないキーは、非アクティブ状態が 14 日間続くと自動的に非アクティブ化されます。

2. 運用ドメインでテストネット API キーを使用すると (またはその逆)、環境の不一致を示す明示的なエラー コードが表示されずに、ただちに認証が失敗します。

3. パスフレーズは大文字と小文字が区別され、不可逆的なハッシュとして保存されます。 1 文字でも間違って入力すると、無効な API キーと区別できない 401 応答が返されます。

4. ソース ファイル内の資格情報のハードコーディングはセキュリティのベスト プラクティスに違反し、デバッグ中やバージョン管理の失敗時にキーが公開される可能性があります。

5. 同じ API キーを使用して複数の同時ログインを試行すると、認証エンドポイントでレート制限がトリガーされ、有効なリクエストが一時的にブロックされる可能性があります。

ネットワークとルーティングの制約

1. 特定のプロキシ サーバーまたは企業ファイアウォールを介してルーティングされたリクエストは、 OK-ACCESS-TIMESTAMPヘッダーを削除または変更し、サーバー側で有効期限切れの検出を引き起こす可能性があります。

2. ロード バランサーまたは CDN は、REST エンドポイント (認証が必要なエンドポイントであっても) の応答をキャッシュすることがあります。これにより、セッション間で古いタイムスタンプが再利用されます。

3. デュアルスタックフォールバックが OS レベルで無効になっている場合、IPv6 のみのネットワーク構成は OKX の DNS レコードを正しく解決できない可能性があります。

4. 古い暗号スイートまたは証明書の固定の不一致による TLS ハンドシェイクの失敗により、ヘッダーが認証層に完全に到達できなくなります。

5. 地理位置情報ベースのルーティングは、グローバル api.okx.com ドメインよりも厳格な検証ルールを適用する地域エンドポイント (myokx.com など) にリクエストを送信する場合があります。

よくある質問

Q: 確認コードを 60 秒以内に入力したにもかかわらず、OKX が拒否するのはなぜですか? A: 拒否はユ​​ーザー入力のタイミングに関するものではなく、サーバー側の署名検証の失敗を反映しています。 「期限切れ」ラベルは、SMS コードの有効期間ではなく、署名されたリクエスト内のタイムスタンプ パラメーターを指します。

Q: 複数のリクエストで同じタイムスタンプを再利用できますか? A: いいえ。各リクエストには、単調増加する一意のタイムスタンプが含まれている必要があります。値を再利用するとアンチリプレイ保護がトリガーされ、エラー コード10000が返されます。

Q: 2 要素認証を有効にすると API ログイン フローに影響しますか? A: はい。 TOTP またはハードウェア キーの登録により、API アクセスに対する SMS ベースの検証が完全に無効になります。 API キー + パスフレーズ + 署名付きリクエストのみが受け入れられます。

Q: ライブリクエストを送信せずに署名ロジックを検証する方法はありますか? A: はい。 OKX は、署名されていない GET リクエストを受け入れるパブリック テスト エンドポイント/api/v5/public/timeを提供します。これを使用して、プライベート エンドポイントに署名する前に、基本的な接続と時間調整を確認します。