构建接入

Java 快速开始

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

以 Markdown 格式查看

安装

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

<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.1.1</version>
</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 流程开启结构化日志。

初始化客户端

import com.sixmm.agent.AgentClient;
import com.sixmm.agent.AgentClientConfig;
AgentClient client = new AgentClient(AgentClientConfig.builder()
        .baseUrl("https://agent-api.6mm.com")
        .agentCode("AGENT001")
        .apiSecret("your-api-secret")
        .defaultCurrency("USDT")
        .build());

仅后端使用

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

资金划入示例

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

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

下一步

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