6MM Agent SDK

この 6MM Agent SDK は、署名やリクエスト処理を一から実装せずに特権エージェント API を呼び出す必要があるパートナーバックエンドサービス向けです。統合はパートナー API シークレットを使用するため、ブラウザ、モバイル、公開デスクトップコードで動作してはなりません。

いつAgent SDK を使うべきか

バックエンドがパートナーユーザーのバインド、承認されたワークフローを通じて資産を移動する、取引記録の照会、埋め込み取引エントリーURLの作成、ウェブフック通知の検証などが必要なときにAgent SDK を活用しましょう。以下の Trading Widget SDK パートナーフロントエンドが取引インターフェースを表示する必要がある場合は別々に。

機能

一般的な構成

典型的な積分フロー

1. パートナーのフロントエンドがパートナー自身のアカウントシステムを通じてユーザーを認証します。
2. パートナーバックエンドはユーザーを安定したパートナー側識別子にマッピングします。
3. バックエンドは、agentCodeと保護されたAPI を秘密にするAgent SDK を呼び出します。
4. SDK が署名し、エージェントにリクエスト API 送る。
5. バックエンドは返還されたビジネス識別子を保存し、後でウェブフックを冪等的に処理します。
6. フロントエンドは必要な短命な結果またはエントリー認証のみを受け取ります。

SDK を選んでください

生産チェックリスト

• apiSecret をソースコードではなくバックエンドのシークレットマネージャから読み込む。
• 開発、ステージング、制作の資格を分けておくこと。
• 安定したパートナーユーザーマッピングと一意のビジネスオーダー識別子を使用すること。
• タイムアウトリクエストのステータスを確認する際に元の識別子を保持すること。
• ウェブフック署名の検証と処理済みイベントIDの保存。
• ログからの秘密情報や署名を黒塗りしつつ、サポートのためにリクエストIDを保持すること。

今後のステップ