设置自动归集
设置自动归集开关及USDT最小值。每天 GMT+8 10:00，满足USDT阈值的钱包全额归集。
POST /open/v1/settings/automation
请求头
| 字段 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| X-App-Id | string | 是 | 平台appID，规范正int64，只传一次。 | 123456789012345001 |
| X-Timestamp | string | 是 | 当前秒级时间戳，服务器时间前后300秒内。 | 1893456000 |
| X-Sign | string | 是 | 本次HMAC-SHA256签名，64位小写十六进制；按签名规则生成。 | 按本次请求计算 |
| Authorization | string | 是 | 当前有效accessToken，格式为 Bearer 后加令牌。 | Bearer <ACCESS_TOKEN> |
| Content-Type | string | 是 | 单个UTF-8 JSON对象。 | application/json |
认证只使用上表请求头；不要发送 Idempotency-Key。示例凭据、ID和地址是演示值，签名必须按实际参数和当前时间重新计算。
请求参数
无路径参数，不接受任何Query（包括仅有问号的URL）。以下字段全部放JSON，额外字段返回400。
| 字段 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| enabled | boolean | 是 | 自动归集的总开关。 | true |
| request_id | string | 是 | 持久化幂等键，JSON 字符串，UTF-8 字节长度16–128，推荐ASCII UUID。创建钱包/归集、修改业务设置、通知重推必填。同租户同操作同键同参数返回原成功结果；同键异参409。只放JSON body，参与签名，不接受Idempotency-Key头。 | "123e4567-e89b-42d3-a456-426614174000" |
json
{
"enabled": true,
"usdt_minimum": "100000000",
"request_id": "automation-20300101-0001"
}业务规则
enabled和usdt_minimum必须完整提交。关闭时金额可为null；开启时必须为大于0且不超过2^256−1的最小单位整数字符串。
开启前必须配置USDT归集地址。
- 每天 GMT+8 10:00，符合 USDT 最小值的钱包全额归集到统一目标。
- 关闭自动归集会取消尚未签名的自动任务；手动任务不受影响，已签名交易继续确认。
配置保存前的当日计划时间不会补执行。相同 request_id 重试不会再次保存策略、改变配置时间或重复取消任务。使用新 request_id 保存则属于新的配置操作。
幂等
JSON request_id 必填，16–128个UTF-8字节，推荐ASCII UUID；与业务参数一起参与签名。同租户同操作同键同参数返回原结果，同键不同参数返回409。超时重试保持原编号，读取最新配置请调用对应GET接口。
成功响应
HTTP 200，外层code=0、message为空字符串。
json
{
"code": 0,
"message": "",
"data": {
"enabled": true,
"usdt_minimum": "100000000"
}
}| 字段 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| code | integer | 是 | 业务成功。 | 0 |
| message | string | 是 | 成功时为空字符串。 | "" |
| data | object | 是 | 本次保存的自动归集策略；幂等重试返回原保存结果。 | "见 JSON 示例" |
| data.enabled | boolean | 是 | 自动归集的总开关。 | true |
失败响应
错误JSON没有data；HTTP状态与code一致。
| HTTP | 情况 |
|---|---|
| 400 | 参数缺失、类型/格式无效或存在不支持的字段 |
| 401 | accessToken、签名或签名时间窗口无效 |
| 403 | 租户停用、删除或过期 |
| 404 | 当前租户及网络的配置记录不存在 |
| 409 | request_id已被同操作不同业务参数使用，或业务状态冲突 |
| 413 / 429 | 请求体过大 / 请求频率超限 |
| 500 / 503 / 504 | 内部依赖错误 / 资源或配置不可用 / 请求超时 |
json
{
"code": 401,
"message": "authentication required or expired",
"error_code": "TOKEN_INVALID_OR_EXPIRED",
"trace_id": "0123456789abcdef0123456789abcdef"
}通用错误说明Retry-After及重试处理；写请求不要因超时生成新的request_id。
业务错误示例
HTTP 400：开启时没有绑定归集地址。
json
{
"code": 400,
"message": "开启自动归集前，请先绑定USDT归集地址",
"error_code": "INVALID_ARGUMENT",
"trace_id": "0123456789abcdef0123456789abcdef"
}HTTP 409：编号相同但修改了阈值。
json
{
"code": 409,
"message": "conflict: idempotency key already used with another request",
"error_code": "IDEMPOTENCY_CONFLICT",
"trace_id": "0123456789abcdef0123456789abcdef"
}完整字段与状态
查看全部响应字段、嵌套对象及枚举 · 业务状态与处理 · 错误码排查。