賬戶信息查詢是云通訊平臺(tái)提供的一個(gè)賬戶管理API,通過此REST API可以方便您對(duì)賬戶進(jìn)行管理。
接口Demo示例可在REST Server Demo中找到,開發(fā)者可根據(jù)使用的語言下載對(duì)應(yīng)的Demo
REST API:賬戶信息查詢
通過HTTPS GET方式提交請(qǐng)求,云通訊平臺(tái)收到請(qǐng)求后,返回主賬號(hào)信息。
1、請(qǐng)求
1.1 請(qǐng)求地址
通過主賬戶Id查詢使用GET方式
/{SoftVersion}/Accounts/{accountSid}/AccountInfo
1.2 請(qǐng)求包頭
請(qǐng)參閱:Rest 介紹》統(tǒng)一請(qǐng)求包頭,使用主賬戶進(jìn)行驗(yàn)證
1.3 請(qǐng)求包體
無
1.4 XML請(qǐng)求示例
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請(qǐng)求示例
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、響應(yīng)
2.1 響應(yīng)包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
statusCode | String | 必選 | 請(qǐng)求狀態(tài)碼,取值000000(成功),可參考Rest 錯(cuò)誤代碼。 |
dateCreated | String | 必選 | 主賬戶的創(chuàng)建時(shí)間 |
dateUpdated | String | 必選 | 主賬戶的最近更新時(shí)間 |
friendlyName | String | 必選 | 主賬戶名稱,唯一,由64個(gè)英文字母和阿拉伯?dāng)?shù)字組成,默認(rèn)為你的電子郵箱地址 |
type | String | 必選 | 主賬戶類型,取值有0(試用)和1(已注冊(cè)),默認(rèn)值為0 |
status | String | 必選 | 主賬戶狀態(tài),取值有0(未激活)、1(激活)、2(暫停)、3(關(guān)閉),默認(rèn)值為0 |
balance | String | 必選 | 主賬戶余額 |
subBalance | String | 必選 | 副賬戶余額 |
2.1 XML響應(yīng)示例
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響應(yīng)示例
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"}}
文檔更新時(shí)間:2017年5月12日