账户信息查询

  • 账户信息查询是云通讯平台提供的一个账户管理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 响应包体

属性类型约束说明
statusCodeString必选请求状态码,取值000000(成功),可参考Rest 错误代码
dateCreatedString必选主账户的创建时间
dateUpdatedString必选主账户的最近更新时间
friendlyNameString必选主账户名称,唯一,由64个英文字母和阿拉伯数字组成,默认为你的电子邮箱地址
typeString必选主账户类型,取值有0(试用)和1(已注册),默认值为0
statusString必选主账户状态,取值有0(未激活)、1(激活)、2(暂停)、3(关闭),默认值为0
balanceString必选主账户余额
subBalanceString必选副账户余额

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"}}