创建子账户
- 子账户是云通讯平台提供给开发者自行管理其客户的账户,子账户隶属于主账号下的一个应用。使用子账户您可以区分您的客户并保证他们可以独立的使用子账户鉴权的REST能力,这样可以使您轻松的管理每一个独立的客户。
- 例如,如果您正在运行一个依赖于云通讯平台的代理服务,您可以为每一个客户注册一个云通讯平台的子账户。如果客户注销了在您服务中的账户,您可以简单地关闭对应的云通讯平台子账户。
- 子账户是一个独立的由开发者自行管理和维护的账户,一个子账户拥有唯一的通讯账号。您可以自行管理一个子账号的电话、短信、录音等而不会影响其他子账号。
计费
- 云通讯平台只对主账号进行计费,当您的主账号因欠费停用时,您的所有子账号也将停用。子账户的费用由您自行管理。
认证
- 您的主账号和所有子账号都可以使用您的主账号证书(主账号ID和主账号令牌)去访问REST API。您可以使用子账号ID和令牌访问该子账号的资源,但您不能使用一个子账号的证书去访问主账号或者其他子账号的资源。
国际
- 目前,云通讯支持拨打某些国家的国际号码,并提供子帐户拨打某些国际目的地的方法。如果您有任何疑问,请联系我们。
REST API: 创建子账户
- 通过HTTPS POST方式提交请求,云通讯平台收到请求后,返回子账户信息。
- 接口Demo示例可在REST Server Demo中找到,开发者可根据使用的语言下载对应的Demo
1、请求
1.1 请求地址
- /{SoftVersion}/Accounts/{accountSid}/SubAccounts
1.2 请求包头
- 请参阅:《Rest 介绍》统一请求包头,使用主账户进行验证
1.3 请求包体
属性 | 类型 | 约束 | 说明 |
appId | String | 必选 | 应用Id |
friendlyName | String | 必选 | 子账户名称。可由英文字母和阿拉伯数字组成子账户唯一名称,推荐使用电子邮箱地址 |
1.4 XML请求示例
- POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/SubAccounts?sig=155EAA68C5DFB6B762A42D88F406ABCD
- HTTP/1.1
- Host:192.168.0.1:8883
- content-length: 139
- Accept:application/xml;
- Content-Type:application/xml;
- charset=utf-8;
- Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
- <?xml version='1.0' encoding='utf-8'?>
- <SubAccount>
- <appId>ff8080813c37da53013c8054f5123456</appId>
- <friendlyName>hello@163.com</friendlyName>
- </SubAccount>
1.5 JSON请求示例
- POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/SubAccounts?sig=155EAA68C5DFB6B762A42D88F406ABCD
- HTTP/1.1
- Host:192.168.0.1:8883
- content-length: 139
- Accept:application/json;
- Content-Type:application/json;
- charset=utf-8;
- Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
- {'appId':'ff8080813c37da53013c8054f5612345','friendlyName':'用户1'}
2、响应
2.1 响应包体
属性 | 类型 | 约束 | 说明 |
statusCode | String | 必选 | 请求状态码,取值000000(成功),可参考Rest 错误代码。 |
subAccountSid | String | 必选 | 子账户Id。由32个英文字母和阿拉伯数字组成的子账户唯一标识符 |
subToken | String | 必选 | 子账户的授权令牌。由32个英文字母和阿拉伯数字组成 |
dateCreated | String | 必选 | 子账户的创建时间 |
voipAccount | String | 必选 | 通讯账号。由14位数字组成,用于客户端SDK登录,作为语音通话及IM功能的唯一标识帐号 |
voipPwd | String | 必选 | 通讯密码。由8位数字和字母组成 |
2.1 XML响应示例
- HTTP/1.1 200 OK
- Content-Length:586
- <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
- <Response>
- <statusCode>000000</statusCode>
- <SubAccount>
- <subAccountSid>abcdefghijklmnopqrstuvwxyz123456</subAccountSid>
- <subToken>666961bb08a14f568d421e6fe57d2d3c</subToken>
- <dateCreated>2013-02-01 15:22:46</dateCreated>
- <voipAccount>80000123456789</voipAccount>
- <voipPwd>xRkazyz3</voipPwd>
- </SubAccount>
- </Response>
2.3 JSON响应示例
- HTTP/1.1 200 OK
- Content-Length:586
- {"statusCode":"000000","SubAccount":{"subAccountSid":"abcdefghijklmnopqrstuvwxyz123456","subToken":"666961bb08a14f568d42176fe571234","dateCreated":"2013-09-27 11:42:24","voipAccount":"80000123456789","voipPwd":" xRkazyz3"}}