Java 快速开始

在后端服务中安装并初始化 Java SDK。

以 Markdown 格式查看

安装

公开 SDK 源码当前使用 v0.1.1 标签,对应 Maven 坐标如下:

1<dependency>
2 <groupId>com.sixmm.exchange.sdk</groupId>
3 <artifactId>agent</artifactId>
4 <version>0.1.1</version>
5</dependency>

GitHub 不是 Maven 依赖仓库。引用依赖前,先在本地安装对应标签的源码:

$git clone https://github.com/6mm-com/agent-java-sdk.git
$cd agent-java-sdk
$git checkout v0.1.1
$mvn install

团队构建

CI、测试和生产构建应把确认后的构件发布到组织内部 Maven 仓库。生产上线前向 6MM 确认批准使用的版本。

源码和使用示例可在官方 Java SDK 仓库查看:

6mm-com/agent-java-sdk

开始前准备

  • 向 6MM 确认生产 Agent API base URL。
  • apiSecret 只保存在后端密钥管理中。
  • 准备 platformUserId 与 agentUserId 的稳定映射。
  • 为 bind、transfer、order 和 webhook 流程开启结构化日志。

初始化客户端

1import com.sixmm.agent.AgentClient;
2import com.sixmm.agent.AgentClientConfig;
3
4AgentClient client = new AgentClient(AgentClientConfig.builder()
5 .baseUrl("https://agent-api.6mm.com")
6 .agentCode("AGENT001")
7 .apiSecret("your-api-secret")
8 .defaultCurrency("USDT")
9 .build());

仅后端使用

不要在浏览器、移动端或桌面客户端中初始化 Agent SDK。Agent SDK 会签名高权限 Agent API 请求。

资金划入示例

1TransferResponse resp = client.transfer(TransferRequest.fixed(
2 "AGT-ORDER-1001",
3 "agent-user-001",
4 Direction.IN,
5 "USDT",
6 "10.00"));

每次划转请求都应使用唯一的合作方订单号。如果请求超时,请先查询原订单状态,再决定是否重试。

下一步

需求下一页
签发 Trading Widget 凭据创建 Embed Token
验证 6MM 回调Webhook 与幂等
查看签名行为密钥与签名
排查接入问题SDK 故障排查