Skip to navigation
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK tích hợp v0.3.0, ví dụ, tham số và ngữ nghĩa phản hồi.

View as Markdown

Hướng dẫn này hướng tới Agent Java SDK v0.3.0, Java 8+ và hợp đồng công khai được gắn thẻ. Các ví dụ chạy trong phần phụ trợ của đối tác sau khi khởi tạo client trong Bắt đầu nhanh.

Đường cơ sở của tài liệu: SDK v0.3.0, cam kết 54aa3c1. Webhook quy tắc nhận bổ sung tuân theo WEBHOOKS.md tại fa6c7b6; đây chỉ là bản cập nhật tài liệu, không có cấu phần phần mềm SDK mới chứa các phương thức trợ giúp cảnh báo.

Phiên bản và cài đặt

MụcGiá trị
Thẻ nguồn ổn địnhv0.3.0
JavaJava 8+
MavenMaven 3.9+
tọa độcom.sixmm.exchange.sdk:agent:0.3.0

Nguồn máy chủ GitHub; nó không làm cho các tọa độ này có thể phân giải được từ Maven Central. Sử dụng cài đặt cục bộ được gắn thẻ hoặc kho lưu trữ tạo tác đã được phê duyệt của bạn.

SDK bao gồm những gì

LoạiKịch bảnSDK APISự miêu tả
Ràng buộc người dùngRàng buộc người dùngbindTạo hoặc tìm nạp liên kết giữa người dùng đối tác và người dùng nền tảng 6MM
Truy vấn nội dungTruy vấn tài khoản đối tácqueryAccountTruy vấn ký quỹ đối tác hoặc tài khoản cấp vốn
Truy vấn nội dungTruy vấn nội dung người dùngqueryUserAssetsTruy vấn tài sản hợp đồng; sử dụng withFunding() để bao gồm số dư Kinh phí
chuyển nhượngChuyển số tiền cố địnhtransferChuyển tiền vào hoặc ra khỏi 6MM
chuyển nhượngChuyển tất cả ra ngoàitransferAllOutDi chuyển tất cả số dư người dùng có thể rút trở lại nền tảng đối tác
chuyển nhượngĐảo ngược thứ tựreverseĐảo ngược quá trình chuyển thành công khi phần phụ trợ hỗ trợ luồng bù
chuyển nhượngThứ tự truy vấnqueryOrderTruy vấn một lệnh chuyển theo mã số đơn hàng của đối tác
chuyển nhượngLiệt kê đơn hànglistOrdersTrang thông qua lệnh chuyển nhượng để đối chiếu
WebhookXác minh chữ kýWebhookVerifier.verifyXác minh các cơ quan cảnh báo sự kiện và thanh lý quỹ thô; mã người bán xử lý thời gian, quyền sở hữu và kiểm tra loại bỏ trùng lặp liên tục. Nhìn thấy Webhook Sự kiện & Cảnh báo thanh lý.
Ví tiền tài trợChuyển tiền tài trợwalletTransferĐối tác ↔ Tài trợ hoặc Tài trợ ↔ Hợp đồng; xác nhận trạng thái trả lại
Ví tiền tài trợTình trạng chuyển tiềnqueryWalletTransferKhôi phục hoạt động cấp vốn bằng cách sử dụng số đơn đặt hàng đối tác ban đầu của nó
Nhập giao dịchVào trực tiếp URLcreateEntryUrlTạo SSO URL một lần cho chế độ chuyển hướng
Nhập giao dịchNhúng mã thông báocreateEmbedTokenTạo mã thông báo tồn tại trong thời gian ngắn cho chế độ Trading Widget tokenProvider
Dữ liệu vĩnh viễnLệnh vĩnh viễn hiện tạilistCurrentPerpetualOrdersTruy vấn các đơn hàng NORMAL hoặc CONDITIONAL hiện tại
Dữ liệu vĩnh viễnLịch sử đặt hàng vĩnh viễnlistPerpetualOrderHistoryThiết bị đầu cuối truy vấn NORMAL hoặc CONDITIONAL lệnh
Dữ liệu vĩnh viễnGiao dịch vĩnh viễnlistPerpetualTradesTruy vấn giao dịch điền vào danh sách người chơi công khai rõ ràng
Dữ liệu vĩnh viễnVị trí vĩnh viễn hiện tạilistCurrentPerpetualPositionsTruy vấn vị trí hiện tại
Dữ liệu vĩnh viễnLịch sử vị trí vĩnh viễnlistPerpetualPositionHistoryTruy vấn các vị trí đã đóng
Dữ liệu vĩnh viễnSổ cái tài khoản vĩnh viễnlistPerpetualLedgerTruy vấn hồ sơ thay đổi số dư hợp đồng cá nhân
Tỷ giá tham chiếu FiatLiệt kê các loại tiền tệ fiat được hỗ trợlistSupportedFiatCurrenciesLiệt kê các loại tiền tệ pháp định hiện có thể chuyển đổi thành USDT
Tỷ giá tham chiếu FiatTruy vấn tỷ giá tham chiếu FXqueryExchangeRatesTruy vấn tỷ lệ tham chiếu fiat-to-USDT hàng ngày cho tất cả hoặc các loại tiền tệ được chọn
Thông tin dịch vụPhiên bản dịch vụversionThông tin phiên bản dịch vụ của Tác nhân truy vấn

Cấu hình

Lấy các giá trị sau từ 6MM trước tích hợp.

MụcVí dụSự miêu tả
baseUrlhttps://agent-api.6mm.comTác nhân API cơ sở URL, không có dấu gạch chéo ở cuối
agentCodeAGENT001Mã đối tác
apiSecretyour-api-secretAPI ký bí mật. Chỉ giữ nó ở phần phụ trợ
defaultCurrencyUSDTĐơn vị tiền tệ mặc định, thường là USDT
webhookUrlhttps://partner.example.com/6mm/webhookCuộc gọi lại của người bán URL được chia sẻ bởi cả bốn loại sự kiện; gửi theo cơ quan event, không có cảnh báo riêng biệt URL.

Khuyến nghị sản xuất:

  • Sử dụng HTTPS cho điểm cuối Tác nhân API và webhook.
  • Lưu trữ apiSecret trong trình quản lý bí mật, trung tâm cấu hình hoặc biến môi trường.
  • Giữ thời gian của máy chủ được đồng bộ hóa, tốt nhất là với NTP.
  • Duy trì tất cả số đơn đặt hàng của đối tác và giữ chúng duy nhất trên toàn cầu.
  • Không bao giờ gửi apiSecret tới trình duyệt, ứng dụng, chương trình nhỏ hoặc mã nguồn giao diện người dùng.

Trường ký tự động

Đối với các cuộc gọi Đại lý đã ký API, SDK sẽ tự động đưa vào:

Cánh đồngNguồnSự miêu tả
agentCodeAgentClientConfig.agentCodeMã đối tác
timestampDấu thời gian Unix UTC hiện tạiGiây
nonceTrình tạo ngẫu nhiên an toànBảo vệ phát lại
signHMAC-SHA256Yêu cầu chữ ký
currencydefaultCurrencyĐược điền khi yêu cầu chuyển khoản/tài khoản bỏ qua loại tiền tệ

Nguyên tắc ký:

  1. Loại trừ sign.
  2. Loại trừ các giá trị trống.
  3. Sắp xếp các khóa theo thứ tự ASCII.
  4. Tham gia với tư cách k=v&k2=v2.
  5. Tính toán hệ thập lục phân HMAC-SHA256 với apiSecret.

Các giá trị mảng được tuần tự hóa dưới dạng JSON nhỏ gọn trước khi tham gia tải trọng ký. Ví dụ: platformUserIds ký hiệu là ["1188041528"], cung cấp platformUserIds=["1188041528"] trong tải trọng k=v. Giữ nguyên thứ tự phần tử mảng, dấu ngoặc kép và ID chuỗi; không chèn khoảng trắng định dạng hoặc sử dụng Java List.toString() (chẳng hạn như [1188041528]). SDK tự động xử lý việc tuần tự hóa này.

Mã doanh nghiệp thông thường không nên tính toán chữ ký hoặc đặt thủ công agentCode, timestamp, nonce hoặc sign.

Nguồn và hướng dẫn liên quan