子账号机制允许访问其他用户名下的设备,项目,组网等资源。对于已经有自己的账号系统的高恪云用户来说,子账号可以将高恪账号和用户自己平台上的账号绑定起来。

创建子账号

在访问子账号名下的资源前,需要先创建子账号。

创建子账号为充值业务,每个子账号需支付10高恪币。

curl -X POST https://api.gocloud.cn/agent/subusers?accesstoken=xxx&phone=13712345678&email=subuser@goclouduser.cn

phone和email至少需要提供一个。

若成功可以获得如下的json格式返回:

{"err":"ok","data":{"id":"12345678"}}

data.id即为新创建的subuserid。

如果手机号已经存在,则系统将返回

{"err":"existed-phone"}

类似的,如果邮箱已经存在,则系统返回

{"err":"existed-email"}

创建子账号将自动扣除高恪币,如果高恪币不足则返回

{"err":"notenough-coins"}

使用子账号

子账号的用法非常简单,在URL中加入subuserid的参数即可,例如

curl -X GET https://api.gocloud.cn/agent/devices?accesstoken=xxx&subuserid=12345678

可以获得子账号ID为12345678的设备列表。

子账号脱离

通过Open API创建的子账号不能在高恪云上正常登陆,但如果有用户使用前文中子账号的手机号13712345678在高恪云上完成了注册流程,则13712345678已成为高恪云用户,不再是子账号,无法继续使用Open API访问13712345678名下的资源。

子账号脱离后高恪币将自动返还。

文档更新时间: 2019-01-16 17:06   作者:Gocloud