創建子賬戶
子賬戶是云通訊平臺提供給開發者自行管理其客戶的賬戶，子賬戶隸屬于主賬號下的一個應用。使用子賬戶您可以區分您的客戶并保證他們可以獨立的使用子賬戶鑒權的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"}}
文檔更新時間：2016年9月8日