SDK 統合のトラブルシューティング

サポートリクエストをエスカレーションする前に、Trading Widget、Agent SDK、署名、webhook、タイムアウト、環境の問題を診断してください。

まず、失敗した操作の環境、タイムスタンプ、ビジネス識別子から始めます。構造化チェックでは通常、構成の問題を認証、ネットワーク、および非同期処理の問題から分離します。

推奨される診断順序

影響を受ける環境とベース URL を確認してください。
UTC の時間範囲と最初に失敗したリクエストを記録します。
モジュールを特定します: Trading Widget、Agent SDK、REST API、WebSocket、または webhook。
リクエスト ID、パートナーユーザー ID、agentOrderNo、オーダー ID、または webhook イベント ID を取得します。
最近のコード、認証情報、IP ホワイトリスト、または展開の変更を確認してください。
最小の安全なテストケースで再現します。

症状	考えられる原因	修理
iframe はパートナーのローカルドメインをリクエストします	baseUrl が見つかりません	baseUrl: ‘https://app.6mm.com’ を渡します。
iframe が表示されないか、非常に短いです	親コンテナには高さがありません	コンテナの高さまたはパスの高さを設定します。
token_provider_missing	パートナートークンモードにはプロバイダーがありません	auth.tokenProviderを追加します。
auth_exchange_failed	無効、期限切れ、または不一致の埋め込みトークン	バックエンドトークンの応答と channelId を確認してください。

Agent SDK の問題

症状	考えられる原因	修理
署名が拒否されました	間違ったシークレット、クロックのずれ、または手動で変更された署名付きフィールド	SDK で署名フィールドを生成し、サーバー時刻を同期させます。
資金移動の重複リスク	タイムアウト後に使用される新しい注文番号	最初に元の agentOrderNo でクエリを実行します。
PROCESSING は失敗として扱われます	保留状態の誤解	webhook を待つか、queryOrder に電話してください。
Webhook が複数回処理されました	冪等性を持たない再試行動作	冪等性キーと最終状態チェックを追加します。

捕らえるべき証拠

統合	有用な証拠
Trading Widget	ページ URL、SDK バージョンパス、ブラウザコンソール、失敗したネットワークリクエスト、`onError` ペイロード、およびコンテナーのディメンション。
Agent SDK	SDK 言語/バージョン、ベース URL、UTC タイムスタンプ、リクエスト ID、`agentOrderNo`、応答コード、およびサニタイズされたログ。
Webhook	配信時間、イベントまたはビジネスキー、署名検証結果、処理状態、およびサニタイズされた生の本体ハッシュ。
REST API	メソッド、パス、環境、リクエストID、レスポンスコード、サニタイズされたパラメータ。

診断には、パスワード、アクセストークン、API シークレット、完全な署名、秘密キー、または編集されていない個人データを決して含めないでください。

エスカレートする前に

操作を再試行しても安全であることが文書化されている場合にのみ再試行してください。
タイムアウト後は、新しいビジネス ID を作成するのではなく、元のビジネス ID をクエリします。
システムクロックと認証情報環境に署名エラーがないか確認します。
最初の失敗とその後の再試行結果を保存します。
を使用します。サポートリクエストのテンプレート編集された完全なレポートを送信します。

関連ドキュメント

Trading Widget クイックスタート

スクリプトの読み込み、コンテナーのサイズ、構成、およびコールバックを確認します。

秘密と署名

Agent SDK 資格情報、クロック、署名済みフィールドを確認してください。

Webhooks & べき等性

コールバックの検証と重複イベントの処理を確認します。

Java v0.3.0 診断

症状	確認と回復
資金調達リクエストの結果は不明です	元の `agentOrderNo` を保持します。元の環境で `queryWalletTransfer` を呼び出します。 `queryOrder` は使用しないでください。
シミュレーション UI に予期しない資金が表示される	フロントエンド `tradingMode` をバックエンド `environment` とは別にチェックします。アカウント `isSimulatedUser` はリクエストをルーティングしません。
クエリエラー `6905`	共有パートナークォータの使用を中止し、同じカーソルを再試行し、SDK でフィルターします。
クエリエラー `6904`	同時クエリを減らし、時間枠を狭めます。解決しない場合はサポートにお問い合わせください。
カーソルが無効または期限切れです	同じ固定履歴ウィンドウを再起動し、保存されたレコードを重複排除します。
新しい Java メソッドがありません	解決された Maven アーティファクトをパブリックタグ `v0.3.0` に対して確認します。アーティファクトポリシーに従って、競合する依存関係を削除します。

クエリとエラーのリファレンス · アップグレードガイド

Webhook の受信に関する問題

症状	点検と取り扱い
失敗を返した後は再試行なし JSON	エンドポイントが引き続き HTTP 200 を返すかどうかを確認します。配信では、本文内の成功インジケーターではなく、HTTP ステータスのみが使用されます。
401 または 409 の後も再試行が続行されます	2xx 以外の応答は既存の再試行ポリシーに従います。署名、通知内容、または販売者の設定を調査します。
清算警告のための空の冪等性キー	現在の `WebhookVerifier.idempotencyKey` は資金イベント ID のみを抽出します。署名と所有権のチェック後、`notificationId` を検証し、販売者コードで警告キーを構築します。空のキーは決して使用しないでください。
処理が成功した後の重複通知	マーチャントおよび `environment` スコープ内で重複排除を維持します。同一の重複の場合は 2xx を返します。レコードが競合し、本体が異なる同じ ID に対して 2xx 以外を返します。
警告は処理されませんでした	`liquidation.warning` および過去の `LIQUIDATION_WARNING` を受け入れます。個別の通知 ID をユーザー、エピソード、またはイベントタイプごとにグループ化して破棄しないでください。
受け入れられた通知は保留中のタスクを失います	2xx を返す前にタスクを確実に保存します。メモリ内の非同期タスクを開始するだけでは不十分です。

イベントフィールドと互換性 · HTTP の応答と信頼できる確認応答