关于API将新增母子用户API key管理接口的公告

火币Global API将新增母子用户API key管理接口,详细如下:

- 子用户API key创建接口“POST /v2/sub-user/api-key-generation”,限母用户可用;
- 母子用户API key信息查询接口 “GET /v2/user/api-key”,限母用户可用;
- 子用户API key修改接口“POST /v2/sub-user/api-key-modification”,限母用户可用;
- 子用户API key删除接口“POST /v2/sub-user/api-key-deletion”, 限母用户可用。

生效日期:2020年6月5日(GMT+8)

具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2020年6月5日

 

子用户创建

POST /v2/sub-user/api-key-generation

请求参数

参数名称是否必须 类型 描述默认值取值范围
otpTokentruestring母用户的谷歌验证码,母用户须在官网页面启用GA二次验证NA6个字符,纯数字
subUidtruelong子用户UIDNA 
notetruestringAPI key备注NA最多255位字符,字符类型不限
permissiontruestringAPI key权限NA取值范围:readOnly、trade,其中readOnly必传,trade选传,两个间用半角逗号分隔。
ipAddressesfalsestringAPI key绑定的IPv4/IPv6主机地址或IPv4网络地址NA最多绑定10个,多个IP地址用半角逗号分隔,如:192.168.1.1,202.106.96.0/24。如果未绑定任何IP地址,API key有效期仅为90天。

响应参数

参数名称 是否必须 数据类型 描述 取值范围
 code true int 状态码 
 message false string 错误描述(如有) 
 data true object  
 { note true string API key备注 
 accessKey true string access key 
 secretKey  true string secret key  
 permission true string API key权限  
 ipAddresses } false string API key绑定的IP地址  

 

母子用户API key信息查询

GET /v2/user/api-key

请求参数

参数名称 是否必须 类型   描述 默认值  取值范围
 uid true long母用户UID,子用户UID NA  
 accessKey false string API key的access key,若缺省,则返回UID对应用户的所有API key NA  

响应参数

参数名称是否必须数据类型描述取值范围
codetrueint状态码 
messagefalsestring错误描述(如有) 
datatrueobject  
[{ accessKeytruestringaccess key 
notetruestringAPI key备注 
permissiontruestringAPI key权限 
ipAddressesfalsestringAPI key绑定的IP地址 
validDaystrueintAPI key剩余有效天数 
statustruestringAPI key当前状态 
createTimetruelongAPI key创建时间 
updateTime }]truelongAPI key最近一次修改时间 

 

修改子用户API key

POST /v2/sub-user/api-key-modification

请求参数

参数名称是否必须类型描述默认值取值范围
subUidtruelong子用户的uidNA 
accessKeytruestring子用户API key的access keyNA 
notefalsestringAPI key备注NA最多255位字符
permissionfalsestringAPI key权限NA取值范围:readOnly、trade,其中readOnly必传,trade选传,两个间用半角逗号分隔。
ipAddressesfalsestringAPI key绑定的IP地址NAIPv4/IPv6主机地址或IPv4网络地址

响应参数

参数名称 是否必须 数据类型 描述 取值范围
 code true int 状态码 
 message false string 错误描述(如有) 
 data true object  
 { note false string API key备注 
 permission false string API key权限  
ipAddresses } false string API key绑定的IP地址  

 

删除子用户API key

POST /v2/ sub-user/api-key-deletion

请求参数

参数名称 是否必须 类型   描述 默认值  取值范围
 subUid true long 子用户的uid NA  
 accessKey true string 子用户API key的access key NA  

响应参数

参数名称 是否必须 数据类型 描述取值范围
 code true int 状态码 
 message false string 错误描述(如有) 

 

API用户需自行评估此以上接口对用户自身业务的适配,并更新相关应用。

所有变更将自本通知生效之日起更新至 Huobi API Docs