Skip to navigation
Agent Java SDK

Produksi & Simulasi Perdagangan

Produksi & Simulasi Perdagangan: 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+.

Pilih mode frontend dan lingkungan dana

Konfigurasikan lingkungan dana backend mitra secara terpisah dari mode perdagangan frontend. Kredensial pengikatan dan entri dibagikan; menerbitkan tiket atau token tidak memilih dompet atau memindahkan dana.

KonfigurasiProduksiDisimulasikan
Pengikatan dan otentikasiPengikatan pengguna bersama dan kredensial satu kaliIdentitas dan otentikasi yang sama
Transfer baru dan saldo penggunaHilangkan environment atau gunakan PRODUCTIONGunakan SIMULATED secara eksplisit
Mendanai pemulihan pesanan awalGunakan lingkungan asli yang disimpanGunakan lingkungan asli yang disimpan
Mode perdagangan widgettradingMode=realtradingMode=demo
Bagian depan HTTP/target WSTarget produksi dipasok oleh 6MMTarget simulasi disediakan oleh 6MM
Enam kueri data abadiData produksiTidak ada pemilih lingkungan; metode ini tidak menanyakan data simulasi

Untuk wallet-transfer-status, menghilangkan environment akan menggunakan lingkungan tersimpan pesanan asli, termasuk pesanan simulasi. Lingkungan yang secara eksplisit bertentangan ditolak. Lebih suka menyimpan lingkungan dan meneruskannya secara eksplisit saat memulihkan operasi.

isSimulatedUser menjelaskan akun tersebut. Itu tidak merutekan permintaan baru ke dompet simulasi. Menghilangkan environment pada permintaan dana baru tetap memilih produksi, meskipun tanda akun benar.

Model permintaan Java yang didukung

Permintaan ini mendukung withEnvironment(ExecutionEnvironment.SIMULATED):

  • TransferRequest, TransferAllOutRequest, ReverseOrderRequest.
  • QueryOrderRequest, ListOrdersRequest.
  • QueryUserAssetsRequest.
  • WalletTransferRequest, WalletTransferQueryRequest.

bind, queryAccount, createEntryUrl, createEmbedToken, dan enam model permintaan kueri abadi tidak memilih lingkungan dana.

import com.sixmm.agent.model.ExecutionEnvironment;
import com.sixmm.agent.model.QueryUserAssetsRequest;
import com.sixmm.agent.model.QueryUserAssetsResponse;
QueryUserAssetsResponse assets = client.queryUserAssets(
        QueryUserAssetsRequest.of("1188041528")
                .withFunding()
                .withEnvironment(ExecutionEnvironment.SIMULATED));

Inisialisasi client menggunakan Mulai Cepat dan gunakan ID pengguna publik dari pengikatan tersimpan Anda.

Melestarikan lingkungan aslinya

Pertahankan jenis antarmuka, agentOrderNo, identitas pengguna, dan lingkungan sebelum mengirim permintaan dana. Pertahankan lingkungan tersebut selama kueri status, pemulihan, rekonsiliasi, dan pemrosesan webhook. Setelah batas waktu habis, jangan pernah mencoba lagi dengan menghilangkan lingkungan asli atau menggunakan nomor pesanan baru.

Transfer Pendanaan/Kontrak tetap dalam satu lingkungan. Dana simulasi tidak bisa menjadi dana produksi. Gunakan akuntansi simulasi sisi mitra yang terpisah dan awalan pesanan yang dapat dikenali seperti SIM-.

Urutan integrasi yang disimulasikan

  1. Ikat pengguna dan simpan ID pengguna platform publik.
  2. Saldo kueri dengan SIMULATED eksplisit dan sertakan Pendanaan bila diperlukan.
  3. Buat simulasi transfer Pendanaan kecil dan pertahankan pesanan bisnis aslinya.
  4. Konfirmasikan hasil akhir dengan kueri status Pendanaan khusus.
  5. Buka atau sematkan halaman detik target dalam mode demo.
  6. Kueri dompet simulasi yang sama dan rekonsiliasi jumlah sebenarnya yang ditransfer.
  7. Untuk menguji perdagangan abadi, transfer Pendanaan simulasi ke Kontrak simulasi dan gunakan antarmuka berjangka simulasi. Enam kueri abadi mitra tidak dapat memvalidasi riwayat perdagangan yang disimulasikan.

Daftar periksa penerimaan

SkenarioBukti untuk diverifikasi
IdentitasPemetaan pengguna yang terikat disimpan; pengguna mitra lain tidak dapat ditanyai.
OtentikasiAlur pengalihan dan penyematan menggunakan kredensial baru; penandatanganan tidak membuat pesanan dana.
DanaKedua belah pihak menyepakati jumlah sebenarnya dan status akhir.
Hasil tidak diketahuiPemulihan menggunakan pesanan awal tanpa membuat transfer kedua.
Isolasi lingkunganTarget backend dan frontend yang disimulasikan setuju; keseimbangan produksi tidak terpengaruh.
PertanyaanFilter pengguna/kategori yang diperlukan, jendela milidetik, halaman kosong, dan kursor ditangani.
Batasan tarifSemua penelepon kueri berbagi pembatasan dan mencoba lagi halaman asli yang gagal.
PenyimpananJumlah dan ID tetap berupa string; catatan entitas disimpan secara idempoten.

Sebelum beralih ke produksi, ubah target dana backend dan mode frontend. Pesanan yang tertunda terus pulih di lingkungan aslinya.

Sumber dan panduan terkait