Agent Java SDK
Agent Java SDK: Agent Java SDK v0.3.0 の統合、例、パラメーター、および応答セマンティクス。
このガイドは、Agent Java SDK v0.3.0、Java 8 以降、およびタグ付けされたパブリック コントラクトを対象としています。例は client を初期化した後にパートナー バックエンドで実行されます。 クイックスタート.
ドキュメントのベースライン: SDK v0.3.0、コミット 54aa3c1。 Webhook の受信ルールはさらに続きます WEBHOOKS.md、fa6c7b6;これはドキュメントのみの更新であり、警告ヘルパー メソッドを含む新しい SDK アーティファクトはありません。
バージョンとインストール
GitHub ホストのソース。これらの座標を Maven Central から解決できるようにするものではありません。タグ付けされたローカル インストールまたは承認されたアーティファクト リポジトリを使用します。
SDK の内容
構成
前に 6MM から次の値を取得します。 統合しています。
制作上の推奨事項:
- エージェント API および webhook エンドポイントには HTTPS を使用します。
apiSecretをシークレット マネージャー、構成センター、または環境変数に保存します。- できれば NTP とサーバー時刻を同期させてください。
- すべてのパートナーの注文番号を保持し、グローバルに一意に保ちます。
apiSecretをブラウザ、アプリ、ミニ プログラム、またはフロントエンドのソース コードに送信しないでください。
自動署名フィールド
署名されたエージェント API 呼び出しの場合、SDK は自動的に以下を挿入します。
署名ルール:
signを除外します。- 空の値を除外します。
- キーを ASCII 順に並べ替えます。
k=v&k2=v2として参加します。apiSecretを使用して HMAC-SHA256 16 進数を計算します。
配列値は、署名ペイロードに結合する前に、コンパクト JSON としてシリアル化されます。たとえば、platformUserIds は ["1188041528"] として署名し、k=v ペイロードに platformUserIds=["1188041528"] を与えます。配列要素の順序、二重引用符、文字列 ID を保持します。書式設定スペースを挿入したり、Java List.toString() ([1188041528] など) を使用したりしないでください。 SDK はこのシリアル化を自動的に処理します。
通常のビジネス コードでは、署名を計算したり、手動で設定したりする必要はありません。
agentCode、timestamp、nonce、または sign。