Skip to navigation
Agent Java SDK

Agent Java SDK

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

View as Markdown

Panduan ini menargetkan Agent Java SDK v0.3.0, Java 8+, dan kontrak publik yang diberi tag. Contoh dijalankan di backend mitra setelah menginisialisasi client di Mulai Cepat.

Dasar dokumentasi: SDK v0.3.0, komit 54aa3c1. Webhook aturan penerimaan juga diikuti WEBHOOKS.md pada fa6c7b6; ini adalah pembaruan hanya dokumentasi, tanpa artefak SDK baru yang berisi metode pembantu peringatan.

Versi dan instalasi

BarangNilai
Tag sumber yang stabilv0.3.0
JavaJava 8+
MavenMaven 3.9+
Koordinatcom.sixmm.exchange.sdk:agent:0.3.0

Sumber host GitHub; hal ini tidak membuat koordinat ini dapat diselesaikan dari Maven Central. Gunakan instalasi lokal yang diberi tag atau repositori artefak yang Anda setujui.

Apa yang Dicakup oleh SDK

KategoriSkenarioSDK APIKeterangan
Pengikatan penggunaIkat penggunabindMembuat atau mengambil pengikatan antara pengguna mitra dan pengguna platform 6MM
Kueri asetAkun mitra kueriqueryAccountTanyakan margin mitra atau akun pendanaan
Kueri asetKueri aset penggunaqueryUserAssetsAset Kontrak Kueri; gunakan withFunding() untuk memasukkan saldo Pendanaan
TransferTransfer jumlah tetaptransferTransfer dana masuk atau keluar dari 6MM
TransferPindahkan semuanyatransferAllOutPindahkan semua saldo pengguna yang dapat ditarik kembali ke platform mitra
TransferUrutan terbalikreverseMembalikkan transfer yang berhasil ketika backend mendukung aliran kompensasi
TransferUrutan kueriqueryOrderKueri satu pesanan transfer berdasarkan nomor pesanan mitra
TransferDaftar pesananlistOrdersHalaman melalui perintah transfer untuk rekonsiliasi
WebhookVerifikasi tanda tanganWebhookVerifier.verifyMemverifikasi badan acara dana mentah dan badan peringatan likuidasi; kode pedagang menangani pemeriksaan waktu, kepemilikan, dan deduplikasi terus-menerus. Melihat Webhook Peristiwa & Peringatan Likuidasi.
Dompet pendanaanTransfer danawalletTransferMitra ↔ Pendanaan atau Pendanaan ↔ Kontrak; konfirmasi status pengembalian
Dompet pendanaanStatus transfer danaqueryWalletTransferMemulihkan operasi Pendanaan menggunakan nomor pesanan mitra aslinya
Entri perdaganganMasuk langsung URLcreateEntryUrlBuat SSO URL satu kali untuk mode pengalihan
Entri perdaganganSematkan tokencreateEmbedTokenBuat token berumur pendek untuk mode Trading Widget tokenProvider
Data abadiPesanan abadi saat inilistCurrentPerpetualOrdersKueri pesanan NORMAL atau CONDITIONAL saat ini
Data abadiSejarah tatanan abadilistPerpetualOrderHistoryTerminal kueri pesanan NORMAL atau CONDITIONAL
Data abadiPerdagangan abadilistPerpetualTradesPertukaran kueri mengisi daftar pemain publik yang eksplisit
Data abadiPosisi abadi saat inilistCurrentPerpetualPositionsKueri posisi saat ini
Data abadiRiwayat posisi abadilistPerpetualPositionHistoryPermintaan posisi tertutup
Data abadiBuku besar akun abadilistPerpetualLedgerKueri catatan perubahan saldo Kontrak individual
Tarif referensi FiatDaftar mata uang fiat yang didukunglistSupportedFiatCurrenciesDaftar mata uang fiat yang saat ini dapat dikonversi ke USDT
Tarif referensi FiatTarif referensi permintaan FXqueryExchangeRatesKueri rasio referensi harian fiat-to-USDT untuk semua atau mata uang yang dipilih
Informasi layananVersi layananversionInformasi versi layanan Agen Kueri

Konfigurasi

Dapatkan nilai berikut dari 6MM sebelumnya mengintegrasikan.

BarangContohKeterangan
baseUrlhttps://agent-api.6mm.comAgen API basis URL, tanpa garis miring
agentCodeAGENT001Kode mitra
apiSecretyour-api-secretAPI rahasia penandatanganan. Simpan di backend saja
defaultCurrencyUSDTMata uang default, biasanya USDT
webhookUrlhttps://partner.example.com/6mm/webhookCallback pedagang URL dibagikan oleh keempat jenis peristiwa; pengiriman berdasarkan isi event, tanpa peringatan terpisah URL.

Rekomendasi produksi:

  • Gunakan HTTPS untuk titik akhir Agen API dan webhook.
  • Simpan apiSecret di manajer rahasia, pusat konfigurasi, atau variabel lingkungan.
  • Jaga waktu server tetap tersinkronisasi, sebaiknya dengan NTP.
  • Pertahankan semua nomor pesanan mitra dan jaga agar nomor tersebut unik secara global.
  • Jangan pernah mengirim apiSecret ke browser, aplikasi, program mini, atau kode sumber frontend.

Bidang Penandatanganan Otomatis

Untuk panggilan Agen API yang ditandatangani, SDK secara otomatis memasukkan:

BidangSumberKeterangan
agentCodeAgentClientConfig.agentCodeKode mitra
timestampStempel waktu Unix UTC saat iniDetik
nonceAmankan generator acakPerlindungan pemutaran ulang
signHMAC-SHA256Minta tanda tangan
currencydefaultCurrencyDiisi ketika permintaan transfer/rekening menghilangkan mata uang

Aturan penandatanganan:

  1. Kecualikan sign.
  2. Kecualikan nilai kosong.
  3. Urutkan kunci berdasarkan urutan ASCII.
  4. Bergabunglah sebagai k=v&k2=v2.
  5. Hitung HMAC-SHA256 hex dengan apiSecret.

Nilai array diserialkan sebagai kompak JSON sebelum bergabung dengan payload penandatanganan. Misalnya, platformUserIds ditandai sebagai ["1188041528"], memberikan platformUserIds=["1188041528"] dalam payload k=v. Pertahankan urutan elemen array, tanda kutip ganda, dan ID string; jangan menyisipkan spasi pemformatan atau menggunakan Java List.toString() (seperti [1188041528]). SDK menangani serialisasi ini secara otomatis.

Kode bisnis normal tidak boleh menghitung tanda tangan atau mengaturnya secara manual agentCode, timestamp, nonce, atau sign.

Sumber dan panduan terkait