Skip to navigation
Agent Java SDK

Tingkatkan ke v0.3.0

Tingkatkan ke v0.3.0: Agent Java SDK integrasi v0.3.0, contoh, parameter, dan semantik respons.

View as Markdown

Panduan ini menargetkan Agent Java SDK v0.3.0 dan Java 8+.

Putuskan apa yang perlu ditingkatkan

Integrasi yang adaTindakan
Fungsi produksi yang ada dengan lingkungan yang dihilangkanBentuk respons yang ada tetap kompatibel; pertanyaan baru tidak memaksa peningkatan.
Otentikasi penyematan umum yang ada untuk perdagangan detikGunakan kembali otentikasi dan pembaruan; pilih halaman produk yang diperlukan.
Saldo pendanaan, transfer dan pemulihanGunakan model yang berisi withFunding, walletTransfer dan queryWalletTransfer.
Dana simulasi eksplisitGunakan model permintaan/respons yang mendukung environment.
Enam kueri data abadiGunakan Java SDK v0.3.0 publik, termasuk enam metode dan dukungan penandatanganan array.

Pertahankan baseUrl, agentCode, apiSecret, pengikatan pengguna, dan pesanan bisnis asli Anda saat ini.

Instal tag publik yang stabil

Sumber host GitHub. Menerbitkan tag GitHub tidak menerbitkan koordinat Maven ke Maven Central. Instal sumber yang diberi tag secara lokal atau publikasikan JAR/POM yang terverifikasi ke repositori artefak organisasi Anda.

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

Kedua ID komit harus cocok. Deklarasikan ketergantungan pada proyek mitra:

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

Verifikasi ketergantungan yang teratasi:

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

Instalasi lokal hanya membuat artefak tersedia di mesin itu. CI dan pengembang lain memerlukan instalasi yang diberi tag yang sama atau repositori artefak terverifikasi Anda. Jika Anda sudah memiliki artefak pribadi bernama 0.3.0, verifikasi sumber dan metodenya; jangan diam-diam menimpa artefak bersama.

Perubahan integrasi yang diperlukan

  1. Perbarui model permintaan dan respons untuk environment eksplisit. Model respons lama yang ketat mungkin menolak kolom tambahan.
  2. Gunakan withFunding() sebelum membaca funding. Saldo kontrak bukanlah saldo perdagangan detik.
  3. Gunakan /v1/agent/wallet-transfer dan /v1/agent/wallet-transfer-status untuk Pendanaan. queryOrder yang lama tidak dapat memulihkan operasi Pendanaan.
  4. Enam kueri menggunakan platformUserIds sebagai array string. Menandatangani array sebagai kompak JSON; Java List.toString() tidak kompatibel.
  5. Simpan pesanan transfer, pesanan perdagangan biasa, pesanan bersyarat, dan pengisian sebagai entitas yang berbeda. Parsing orderStatus atau status sesuai dengan operasinya.
  6. Verifikasi isi webhook asli sebelum penguraian. Notifikasi simulasi eksplisit mencakup environment; bandingkan dengan pesanan yang disimpan.
  7. Kelola versi Java dan Widget secara mandiri. Peningkatan backend tidak mengubah halaman frontend atau mode perdagangan, dan perdagangan detik tidak memerlukan jenis token baru.

Verifikasi peningkatan

Jalankan pembangunan proyek mitra dan periksa pohon ketergantungannya. Pengikatan pengujian, alur produksi asli, saldo simulasi eksplisit, Pemulihan hasil pendanaan, keenam kueri, penomoran halaman jendela tetap, penanganan kesalahan, dan panggilan balik idempoten.

Untuk klien HTTP khusus, ikuti permintaan yang diberi tag dan kontrak tanda tangan alih-alih berasumsi model lama mencakup bidang baru. Melihat Aturan penandatanganan agen, Ikhtisar kueri Dan Panduan lingkungan.

Sumber dan panduan terkait