修改下级用户 API Key 权限
- POST
/api/v3/accountCenter/apiKey/permissions
权重(IP): 5
覆盖指定下级用户 API Key 的权限、IP 白名单和备注。若修改后的权限包含非只读权限,必须传 IP 白名单。
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| subUserId | Long | 是 | 下级用户 UID。 |
| apiKey | String | 是 | 待修改的 API Key。 |
| authorities | String[] | 是 | 覆盖后的 API Key 权限。 |
| ipWhiteList | String[] | 条件必填 | IP 白名单,最多 10 个。包含非只读权限时必填。 |
| remark | String | 否 | API Key 备注。 |
权限枚举
| 权限枚举 | 说明 |
|---|---|
ACCOUNT_DETAILS | 账户详情,只读权限。 |
SPOT_TRADING | 现货交易权限。 |
FUTURES_TRADING | 合约交易权限。 |
TRANSFER | 资金划转权限。 |
WITHDRAW | 提币权限。 |
请求示例
{
"subUserId": 1234567890,
"apiKey": "weex_xxxxxxxxxxxxxxxxxxxxxxxx",
"authorities": ["ACCOUNT_DETAILS"],
"ipWhiteList": [],
"remark": "readonly key"
}
返回参数
| 字段名 | 类型 | 字段说明 |
|---|---|---|
| subUserId | Long | 下级用户 UID。 |
| authorities | String[] | 修改后的 API Key 权限。 |
| ipWhiteList | String[] | 修改后的 IP 白名单。 |
| ts | Long | 操作成功时间戳,毫秒。 |
返回示例
{
"subUserId": 1234567890,
"authorities": ["ACCOUNT_DETAILS"],
"ipWhiteList": [],
"ts": 1780000000000
}