中文帮助文档>Rest API

Client账号查询

通过HTTPS GET方式提交Client账号查询请求,轻码云开放平台收到请求后根据Client号码、Client号码绑定的手机号等查询并返回Client信息。

请求地址:
/{SoftVersion}/accounts/{accountSid}/clientList
验证级别:
主账号验证级别,请求地址中的 {accountSid}代表主账号id(ACCOUNT SID)。
地址样例:
https://api.qingmayun.com/20141029/accounts/823deef8e529477185a52179325b4a62/clientList?sig=84b81c1d13911dd6cd35e63b4db988e8&timestamp=20141116113918
支持格式:
JSON,XML
HTTPS请求方式:
POST

请求包体

属性 类型 约束 说明
appId String 必选 应用Id
start String 可选 开始的序号,默认从0开始
mobile String 可选 Client绑定的手机号码。
limit String 可选 一次查询的最大条数,最小是1条,最大是100条
clientNumber String 可选 Client号码。

响应包体

属性 类型 约束 说明
respCode String 必选 请求状态码,取值00000(成功),具体可参考状态码
count String 必选 Client数量。
clientNumber String 必选 Client号码。
clientPwd String 必选 Client密码。
mobile String 可选 Client绑定的手机号码。
balance String 必选 Client余额。
createDate String 必选 创建时间,时间格式(yyyy-MM-dd HH:mm:ss)。
status String 可选 Client状态。0:关闭,1:开启。

XML请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/clientList?sig=84b81c1d13911dd6cd35e63b4db988e8
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8

<?xml version="1" encoding="utf-8"?>
<client>
  <appId>624e76e6486648cd8be0dee3b5cc9957</appId>
  <start>0</start>
  <limit>3</limit>
</client>

JSON请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/clientList?sig=84b81c1d13911dd6cd35e63b4db988e8
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/json
Content-Type:application/json;charset=utf-8

 {
    "client": {
        "appId": "624e76e6486648cd8be0dee3b5cc9957", 
        "start": "0", 
        "limit": "3"
    }
}

XML响应实例

<?xml version="1" encoding="utf-8"?>
<result>
  <respCode>00000</respCode>
  <count>3</count>
  <client>
    <clientNumber>61974724584902</clientNumber>
    <clientPwd>ee1f65d31809467f97060b0a26e92524</clientPwd>
    <mobile/>138xxxxxxxx</mobile/>
    <status>1</status>
    <balance>1</balance>
    <createDate>2014-12-08 19:48:38</createDate>
  </client>
  <client>
    <clientNumber>61974724584903</clientNumber>
    <clientPwd>f8dad40a1e4d43e08a9047bb4511c607</clientPwd>
    <mobile/>185xxxxxxxx</mobile/>
    <status>1</status>
    <balance>1</balance>
    <createDate>2014-12-08 19:47:51</createDate>
  </client>
  <client>
    <clientNumber>61974724584904</clientNumber>
    <clientPwd>f56ee8fc2db94f7f8e96f2f19b8c9a2f</clientPwd>
    <mobile>132xxxxxxxx</mobile>
    <status>1</status>
    <balance>1</balance>
    <createDate>2014-12-08 19:44:30</createDate>
  </client>
</result>

JSON响应实例

 {
    "result": {
        "respCode": "00000", 
        "count": "3", 
        "client": [
            {
                "createDate": "2014-12-08 19:48:38", 
                "mobile": "138xxxxxxxx", 
                "status": "1", 
		"balance": 1, 
                "clientNumber": "61974724584902", 
                "clientPwd": "ee1f65d31809467f97060b0a26e92524"
            }, 
            {
                "createDate": "2014-12-08 19:47:51", 
                "mobile": "185xxxxxxxx", 
                "status": "1", 
		"balance": 1, 
                "clientNumber": "61974724584903", 
                "clientPwd": "f8dad40a1e4d43e08a9047bb4511c607"
            }, 
            {
                "createDate": "2014-12-08 19:44:30", 
                "mobile": "132xxxxxxxx", 
                "status": "1", 
		"balance": 1, 
                "clientNumber": "61974724584904", 
                "clientPwd": "f56ee8fc2db94f7f8e96f2f19b8c9a2f"
            }
        ]
    }
}