v0.3.0 にアップグレードする

このガイドは、Agent Java SDK v0.3.0 および Java 8 以降を対象としています。

何をアップグレードする必要があるかを決定する

現在の baseUrl、agentCode、apiSecret、ユーザー バインディング、および元の業務命令を保存します。

安定したパブリックタグをインストールする

GitHub ホストのソース。 GitHub タグを公開しても、Maven 座標は Maven Central に公開されません。タグ付けされたソースをローカルにインストールするか、その検証済みの JAR/POM を組織のアーティファクト リポジトリに公開します。

git clone --branch v0.3.0 --single-branch https://github.com/6mm-com/agent-java-sdk.git agent-java-sdk-v0.3.0
cd agent-java-sdk-v0.3.0
git rev-parse HEAD
git rev-parse 'v0.3.0^{commit}'
mvn install

2 つのコミット ID は一致する必要があります。パートナー プロジェクトで依存関係を宣言します。

<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.3.0</version>
</dependency>

解決された依存関係を確認します。

mvn dependency:tree -Dincludes=com.sixmm.exchange.sdk:agent

ローカルにインストールすると、アーティファクトはそのマシン上でのみ使用可能になります。 CI および他の開発者には、同じタグ付きインストールまたは検証済みアーティファクト リポジトリが必要です。 0.3.0 という名前のプライベート アーティファクトがすでにある場合は、そのソースとメソッドを確認してください。共有アーティファクトをサイレントに上書きしないでください。

必要な統合の変更

1. 明示的な environment のリクエストおよびレスポンス モデルを更新します。厳密な古い応答モデルでは、追加フィールドが拒否される場合があります。
2. funding を読む前に withFunding() を使用してください。契約残高は秒単位の取引残高ではありません。
3. 資金調達には /v1/agent/wallet-transfer と /v1/agent/wallet-transfer-status を使用してください。古い queryOrder は資金調達操作を回復できません。
4. 6 つのクエリは、文字列配列として platformUserIds を使用します。配列をコンパクト JSON として署名します。 Java List.toString() には互換性がありません。
5. 転送注文、通常の取引注文、条件付き注文および約定を別個のエンティティとして保存します。操作に従って orderStatus または status を解析します。
6. 解析する前に、元の webhook の本文を確認してください。明示的にシミュレートされた通知には environment が含まれます。保存された順序と比較してください。
7. Java とウィジェットのバージョンを個別に管理します。バックエンドのアップグレードではフロントエンド ページや取引モードは変更されず、秒取引では新しいトークン タイプは必要ありません。

アップグレードを確認する

パートナー プロジェクトのビルドを実行し、その依存関係ツリーを検査します。テスト バインディング、元の運用フロー、明示的にシミュレートされた残高、資金調達結果の回復、6 つのクエリすべて、固定ウィンドウのページネーション、エラー処理、冪等コールバック。

カスタム HTTP クライアントの場合は、古いモデルが新しいフィールドをカバーすると仮定するのではなく、タグ付けされたリクエストと署名コントラクトに従います。見る エージェントの署名ルール, クエリの概要 そして 環境ガイド.

ソースおよび関連ガイド

• 公式 v0.3.0 ソース
• クエリの概要とページネーション
• 資金調達ウォレット