創(chuàng)建子賬戶
子賬戶是云通訊平臺提供給開發(fā)者自行管理其客戶的賬戶，子賬戶隸屬于主賬號下的一個應(yīng)用。使用子賬戶您可以區(qū)分您的客戶并保證他們可以獨立的使用子賬戶鑒權(quán)的REST能力，這樣可以使您輕松的管理每一個獨立的客戶。
例如，如果您正在運行一個依賴于云通訊平臺的代理服務(wù)，您可以為每一個客戶注冊一個云通訊平臺的子賬戶。如果客戶注銷了在您服務(wù)中的賬戶，您可以簡單地關(guān)閉對應(yīng)的云通訊平臺子賬戶。
子賬戶是一個獨立的由開發(fā)者自行管理和維護的賬戶，一個子賬戶擁有唯一的通訊賬號。您可以自行管理一個子賬號的電話、短信、錄音等而不會影響其他子賬號。
計費
云通訊平臺只對主賬號進行計費，當(dāng)您的主賬號因欠費停用時，您的所有子賬號也將停用。子賬戶的費用由您自行管理。
認證
您的主賬號和所有子賬號都可以使用您的主賬號證書（主賬號ID和主賬號令牌）去訪問REST API。您可以使用子賬號ID和令牌訪問該子賬號的資源，但您不能使用一個子賬號的證書去訪問主賬號或者其他子賬號的資源。
國際
目前，云通訊支持撥打某些國家的國際號碼，并提供子帳戶撥打某些國際目的地的方法。如果您有任何疑問，請聯(lián)系我們。
REST API: 創(chuàng)建子賬戶
通過HTTPS POST方式提交請求，云通訊平臺收到請求后，返回子賬戶信息。
接口Demo示例可在REST Server Demo中找到，開發(fā)者可根據(jù)使用的語言下載對應(yīng)的Demo
1、請求
1.1 請求地址
/{SoftVersion}/Accounts/{accountSid}/SubAccounts
1.2 請求包頭
請參閱：Rest 介紹》統(tǒng)一請求包頭，使用主賬戶進行驗證
1.3 請求包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| appId | String | 必選 | 應(yīng)用Id |
| friendlyName | String | 必選 | 子賬戶名稱。可由英文字母和阿拉伯?dāng)?shù)字組成子賬戶唯一名稱，推薦使用電子郵箱地址 |
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、響應(yīng)
2.1 響應(yīng)包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| statusCode | String | 必選 | 請求狀態(tài)碼，取值000000（成功），可參考Rest 錯誤代碼。 |
| subAccountSid | String | 必選 | 子賬戶Id。由32個英文字母和阿拉伯?dāng)?shù)字組成的子賬戶唯一標(biāo)識符 |
| subToken | String | 必選 | 子賬戶的授權(quán)令牌。由32個英文字母和阿拉伯?dāng)?shù)字組成 |
| dateCreated | String | 必選 | 子賬戶的創(chuàng)建時間 |
| voipAccount | String | 必選 | 通訊賬號。由14位數(shù)字組成，用于客戶端SDK登錄，作為語音通話及IM功能的唯一標(biāo)識帳號 |
| voipPwd | String | 必選 | 通訊密碼。由8位數(shù)字和字母組成 |
2.1 XML響應(yīng)示例
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響應(yīng)示例
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日