======1.Client帐号管理======
----
帐号管理主要提供给开发者用于关联自己的帐号体系到云之讯平台，并且对云之讯平台的帐号进行管理，帐号操作管理主要包括：创建帐号、释放帐号、根据手机查询帐号、查询帐号信息。
===== 1.1创建帐号 =====
通过HTTPS POST方式提交请求，云之讯融合通讯开放平台收到请求后，创建Client帐号与开发者提供的用户注册帐号关联。\\

**请求**
<code java>
/{SoftVersion}/Accounts/{accountSid}/Clients
</code>

**请求包头**

详情请查阅统一请求包头，并使用开发者账号进行验证。

**请求包体**

^属性 ^类型 ^约束 ^说明 |
|appId	|String	|必选 |开发者创建的应用ID，UCpaas平台生成，固定32位长度|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位，应用下唯一。|
|friendlyName	|String	|可选	|开发者应用下注册用户对应的昵称，数字、字母（区分大小写）、下划线组成，最长50位|
|mobile	|String	|可选	|绑定的手机号码，同一个应用内唯一。|


**XML请求示例：**
<code xml>
POST/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Clients?sig=3C861C9CFA64862A79B906D80EDB79BA
Host: api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzE2MzI=

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<client>
    <appId>e462aba25bc6498fa5ada7eefe1401b7</appId>
    <userId>123867124912354679</userId>
    <friendlyName>97854038</friendlyName>
    <mobile>18612345678</mobile>
</client>
</code>
**JSON请求示例:**
<code java>
POST/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Clients?sig=027282406B5E0E66F4EFE2A86B7A60F7
Host: api.ucpaas.com
Accept:application/json
Content-Type:application/json;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzMwMzg=

{
 "client"   : {
        "appId"        : "e462aba25bc6498fa5ada7eefe1401b7",
	"userId"       : "123867124912354679",
	"friendlyName" : "76598140",
        "mobile"       : "18612345678"
    }
}
</code>
**响应**

**响应包体**
^属性 ^类型 ^约束 ^说明 |
|respCode |String |必选 |响应状态码，定长6位，取值000000（成功)，具体状态码见状态码说明|
|client |String |必选 |client列表，节点的名称|
|clientNumber|String |必选 |UCPaas平台生成的唯一用户id，定长14位数字|
|clientPwd|String |必选 |用户帐号密码，数字和字母混合，定长8位|
|loginToken|String |必选 |UCPaas平台用户令牌|
|createDate|String |必选 |创建日期，格式yyyy-mm-dd hh:mm:ss|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位，应用下唯一|

**XML响应示例：**
<code xml>
HTTP/1.1 200 OK
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
    <client>
        <clientNumber>66807000020828</clientNumber>
        <clientPwd>a9316df8</clientPwd>
	<loginToken>e03bc9106c6ed0eaebfce8c368fdcd48</loginToken>
        <createDate>2015-06-23 17:16:27</createDate>
        <userId>123867124912354679</userId>      
    </client>
</resp>
</code>

**JSON响应示例:**
<code java>
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
 "resp"   : {
    "respCode"   : "000000",
    "client"     : {
        "clientNumber" : 66807000020827,
        "clientPwd"    : "c4ad7da6",
        "loginToken"   : "e03bc9106c6ed0eaebfce8c368fdcd48",
        "createDate"   : "2015-06-23 17:15:04",
        "userId"       : "123867124912354679"
        }
    }
}
</code>
===== 1.2释放帐号 =====
通过HTTPS POST方式提交请求，云之讯融合通讯开放平台收到请求后，在云之讯平台上释放关闭对应开发者应用下用户的帐号。\\

**请求**
<code java>
/{SoftVersion}/Accounts/{accountSid}/dropClient
</code>

**请求包头**

详情请查阅统一请求包头，并使用开发者账号进行验证。

**请求包体**

^属性 ^类型 ^约束 ^说明 |
|appId	|String	|必选 |开发者创建的应用ID，UCpaas平台生成，固定32位长度|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位，应用下唯一|

**XML请求示例：**
<code xml>
POST/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/dropClient?sig=3C861C9CFA64862A79B906D80EDB79BA
Host: api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzE2MzI=

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<client>
    <appId> e462aba25bc6498fa5ada7eefe1401b7</appId>
    <userId>123867124912354679</userId>
</client>
</code>
**JSON请求示例:**
<code xml>
POST/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/dropClient?sig=027282406B5E0E66F4EFE2A86B7A60F7
Host: api.ucpaas.com
Accept:application/json
Content-Type:application/json;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzMwMzg=

{
 "client"   : {
    "appId"  : "e462aba25bc6498fa5ada7eefe1401b7",
    "userId" : "123867124912354679",
    }
}
</code>
**响应**

**响应包体**
^属性 ^类型 ^约束 ^说明 |
|respCode |String |必选 |响应状态码，定长6位，取值000000（成功)，具体状态码见状态码说明|

**XML响应示例：**
<code xml>
HTTP/1.1 200 OK
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
</resp>
</code>

**JSON响应示例:**
<code java>
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
 "resp"   : {
    "respCode"   : "000000"
    }
}
</code>

===== 1.3根据手机号查询子帐号 =====
通过HTTPS GET方式提交请求，云之讯融合通讯开放平台收到请求后，返回开发者应用下与手机号绑定的用户帐号信息\\

**请求**
<code java>
/{SoftVersion}/Accounts/{accountSid}/ClientsByMobile
</code>

**请求包头**

详情请查阅统一请求包头，并使用开发者账号进行验证。

**请求包体**

^属性 ^类型 ^约束 ^说明 |
|appId	|String	|必选 |开发者创建的应用ID，UCpaas平台生成，固定32位长度|
|mobile |String	|必选	|手机号码|

**XML请求示例：**
<code xml>
GET/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/ClientsByMobile?sig=0E270413B0B038B7AEB6997F510F98EB&mobile=18612345678&appId=e462aba25bc6498fa5ada7eefe1401b7
Host: api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzE2MzI=
</code>
**JSON请求示例:**
<code java>
GET/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/ClientsByMobile?sig=83D00E8EF62FC601A4035AE7EEF6197F&mobile=18612345678&appId=e462aba25bc6498fa5ada7eefe1401b7
Host: api.ucpaas.com
Accept:application/json
Content-Type:application/json;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzMwMzg=
</code>
**响应**

**响应包体**
^属性 ^类型 ^约束 ^说明 |
|respCode |String |必选 |响应状态码，定长6位，取值000000（成功)，具体状态码见状态码说明|
|client |String |必选 |client列表，节点的名称|
|friendlyName |String |必选 |开发者应用下用户在UCPaas平台注册的昵称，数字、字母（区分大小写）、下划线组成，最长50位|
|mobile |String |可选 |用户帐号绑定的手机号|
|clientNumber |String |必选 |UCPaas平台生成的唯一用户id，定长14位数字|
|clientPwd |String |必选 |用户帐号密码，数字和字母混合，定长8位|
|createDate |String |必选 |创建日期，格式yyyy-mm-dd hh:mm:ss|
|loginToken|String |必选 |UCPaas平台用户令牌|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位，应用下唯一|

**XML响应示例：**
<code xml>
HTTP/1.1 200 OK
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
    <client>  /*Client为节点*/
        <clientNumber>66807000020851</clientNumber>
        <clientPwd>afabcaa9</clientPwd>
        <createDate>2015-06-23 18:41:51</createDate>
        <friendlyName>71127894</friendlyName>
        <mobile>18612345678</mobile>
        <loginToken>e03bc9106c6ed0eaebfce8c368fdcd48</loginToken>
        <userId>123867124912354679</userId>
    </client>
</resp>
</code>

**JSON响应示例:**
<code java>
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
 "resp"   : {
    "respCode"   : "000000",
    "client"     : {
        "clientNumber" : "66807000020851",
        "clientPwd"    : "afabcaa9",
        "createDate"   : "2014-06-23 18:41:51",
        "friendlyName" : "71127894",
        "mobile"       : "18612345678",
        "loginToken"   : "e03bc9106c6ed0eaebfce8c368fdcd48",
        "userId"       : "123867124912354679"
        }
    }
}
</code>
===== 1.4根据userId查询子帐号 =====
通过HTTPS GET方式提交请求，云之讯融合通讯开放平台收到请求后，返回开发者应用下与UserId绑定的用户帐号信息\\

**请求**
<code java>
/{SoftVersion}/Accounts/{accountSid}/ClientsByUserId
</code>

**请求包头**

详情请查阅统一请求包头，并使用开发者账号进行验证。

**请求包体**

^属性 ^类型 ^约束 ^说明 |
|appId	|String	|必选 |开发者创建的应用ID，UCpaas平台生成，固定32位长度|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位，应用下唯一|

**XML请求示例：**
<code xml>
GET/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/ClientsByUserId?sig=0E270413B0B038B7AEB6997F510F98EB&userId=18612345678123&appId=e462aba25bc6498fa5ada7eefe1401b7
Host: api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzE2MzI=
</code>
**JSON请求示例:**
<code java>
GET/2015-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/ClientsByUserId?sig=83D00E8EF62FC601A4035AE7EEF6197F&userId=18612345678123&appId=e462aba25bc6498fa5ada7eefe1401b7
Host: api.ucpaas.com
Accept:application/json
Content-Type:application/json;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxNzMwMzg=
</code>
**响应**

**响应包体**
^属性 ^类型 ^约束 ^说明 |
|respCode |String |必选 |响应状态码，定长6位，取值000000（成功)，具体状态码见状态码说明|
|client |String |必选 |client列表，节点的名称|
|friendlyName |String |必选 |开发者应用下用户在UCPaas平台注册的昵称，数字、字母（区分大小写）、下划线注册，最长50位|
|mobile |String |可选 |用户帐号绑定的手机号|
|clientNumber |String |必选 |UCPaas平台生成的唯一用户id，定长14位数字|
|clientPwd |String |必选 |用户帐号密码，数字和字母混合，定长8位|
|createDate |String |必选 |创建日期，格式yyyy-mm-dd hh:mm:ss|
|loginToken|String |必选 |UCPaas平台用户令牌|
|userId |String	|必选	|开发者应用下注册用户的ID，数字、字母（区分大小写）组成，最长31位|

**XML响应示例：**
<code xml>
HTTP/1.1 200 OK
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<resp>
    <respCode>000000</respCode>
    <client>  /*Client为节点*/
        <clientNumber>66807000020851</clientNumber>
        <clientPwd>afabcaa9</clientPwd>
        <createDate>2015-06-23 18:41:51</createDate>
        <friendlyName>71127894</friendlyName>
        <mobile>18612345678</mobile>
        <loginToken>e03bc9106c6ed0eaebfce8c368fdcd48</loginToken>
        <userId>123867124912354679</userId>
    </client>
</resp>
</code>

**JSON响应示例:**
<code java>
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
 "resp"   : {
    "respCode"   : "000000",
    "client"     : {
        "clientNumber" : "66807000020851",
        "clientPwd"    : "afabcaa9",
        "createDate"   : "2014-06-23 18:41:51",
        "friendlyName" : "71127894",
        "mobile"       : "18612345678",
        "loginToken"   : "e03bc9106c6ed0eaebfce8c368fdcd48",
        "userId"       : "123867124912354679"
        }
    }
}
</code>
===== 1.5SDK2.0升级至3.0注意事项 =====
1. client账号申请的post请求里，版本号为“2014-06-30”，此版本称为”账号体系2014“；版本号为“2015-06-30”，此版本称为”账号体系2015“。\\
2. 账号体系2014在3.0SDK中只能使用明文登录方式，即原有的clientnumber+password方式，无法使用账号体系2014 token方式登录。\\
3. 3.0 SDK版本接口使用的是userid操作风格，2.0 SDK开发者可以沿用之前的client账号，把clientnumber作为userid使用。\\
4. 注意，如果希望同时使用互联网音视频3.0和即时通信（IM）业务，则需要全部使用账号体系2015。\\