賬戶信息查詢是云通訊平臺提供的一個賬戶管理API,通過此REST API可以方便您對賬戶進行管理。
接口Demo示例可在REST Server Demo中找到,開發者可根據使用的語言下載對應的Demo
REST API:賬戶信息查詢
通過HTTPS GET方式提交請求,云通訊平臺收到請求后,返回主賬號信息。
1、請求
1.1 請求地址
通過主賬戶Id查詢使用GET方式
/{SoftVersion}/Accounts/{accountSid}/AccountInfo
1.2 請求包頭
請參閱:Rest 介紹》統一請求包頭,使用主賬戶進行驗證
1.3 請求包體
無
1.4 XML請求示例
GET /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/AccountInfo?sig=C1F20E7A9733CE94F680C70A1DBABCDE HTTP/1.1 Host:192.168.0.1:8883 Accept:application/xml; Content-Type:application/xml;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
1.5 JSON請求示例
GET /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/AccountInfo?sig=C1F20E7A9733CE94F680C70A1DBABCDE HTTP/1.1 Host:192.168.0.1:8883 Accept:application/json; Content-Type:application/json;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
2、響應
2.1 響應包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
statusCode | String | 必選 | 請求狀態碼,取值000000(成功),可參考Rest 錯誤代碼。 |
dateCreated | String | 必選 | 主賬戶的創建時間 |
dateUpdated | String | 必選 | 主賬戶的最近更新時間 |
friendlyName | String | 必選 | 主賬戶名稱,唯一,由64個英文字母和阿拉伯數字組成,默認為你的電子郵箱地址 |
type | String | 必選 | 主賬戶類型,取值有0(試用)和1(已注冊),默認值為0 |
status | String | 必選 | 主賬戶狀態,取值有0(未激活)、1(激活)、2(暫停)、3(關閉),默認值為0 |
balance | String | 必選 | 主賬戶余額 |
subBalance | String | 必選 | 副賬戶余額 |
2.1 XML響應示例
HTTP/1.1 200 OK Content-Length: 641 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response> <statusCode>000000</statusCode> <Account> <friendlyName>help@163.com</friendlyName> <type>0</type> <status>1</status> <dateCreated>2013-02-01 15:38:09</dateCreated> <dateUpdated>2013-02-01 15:38:09</dateUpdated> <balance>0.0</balance> <subBalance>112.0</balance> </Account> </Response>
2.3 JSON響應示例
HTTP/1.1 200 OK Content-Length: 641 {"statusCode":"000000","Account":{"balance":"211","subBalance":"112","status":"1","friendlyName":"123456789@qq.com", "dateCreated":"2013-02-19 14:59:18","type":"1","dateUpdated":"2013-09-27 09:13:33"}}
文檔更新時間:2017年5月12日