注意： 为了确保数据隐私和安全， REST API须通过HTTPS方式请求
**URL格式** \\
https://api.ucpaas.com/{SoftVersion}/Accounts/{accountSid}/{function}/{operation}?sig={SigParameter}\\
**URL参数属性说明**\\
^属性 ^ ^说明 ^
|SoftVersion | |云之讯REST API版本号，当前版本号为：2014-06-30 |
|Account | |此参数为默认固定值 |
|accountSid | | 注册云之讯官网，在控制台中即可获取此参数 |
|function | | 业务功能 |
|operation | | 业务操作，业务功能的各类具体操作分支 |
|SigParameter | | 请求URL必须带有此参数 |
**HTTP标准包头字段(必填)** \\
^属性 ^ ^说明 ^
|Accept | |客户端响应接收数据格式：application/xml、application/json |
|Content-Type | |类型：application/xml;charset=utf-8、application/json;charset=utf-8 |
|Authorization | |验证信息 |
|Content-Length | |包体长度 |
**关键点**\\
SigParameter是REST API 验证参数：
1、URL后必须带有sig参数，sig= MD5（账户Id + 账户授权令牌 + 时间戳），共32位(注:转成大写)
2、使用MD5加密（账户Id + 账户授权令牌 + 时间戳），共32位
3、时间戳是当前系统时间（24小时制），格式“yyyyMMddHHmmss”。时间戳有效时间为50分钟
Authorization是包头验证信息：
1、使用Base64编码（账户Id + 冒号 + 时间戳）
2、冒号为英文冒号
3、时间戳是当前系统时间（24小时制），格式“yyyyMMddHHmmss”，需与SigParameter中时间戳相同
**开发者信息说明**
1.开发者账号ID--Account Sid
a.开发者在UcPaaS平台的唯一标示，在SDK登录、REST请求中使用；
b.开发者账号ID在网站注册后，系统自动生成，不可以更改
2.账户授权令牌--Auth Token
a.相当于开发者账号ID（Account Sid）的密码，在SDK登录、REST请求中使用；
b.系统自动生成；如果出现开发者Token泄露的情况，系统支持开发者Token重置。
c.需要注册手机进行验证后方可查看
===1 短信发送接口===
1.appId：创建应用时系统分配的唯一标示，在“应用列表”中可以查询 \\
2.templateId：创建短信模板时系统分配的唯一标示，在“短信管理”中可以查询\\
3. to：需要下发短信的手机号码,支持国际号码，需要加国家码。 \\
4.param：模板中的替换参数，如果有多个参数则需要写在同一个字符串中，以逗号分隔.
（如：param=“a,b,c”）
应用未上线只可以用【应用测试】绑定的号码测试。（点击“【应用测试】进行号码绑定”）
----
POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Messages/templateSMS?sig=769190B9A223549407D2164CAE92152E
Host:api.ucpaas.com
Accept:application/json
Content-Type:application/json;charset=utf-8
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODUwMjE=
{
"templateSMS" : {
"appId" : "e462aba25bc6498fa5ada7eefe1401b7",
"param" : "0000",
"templateId" : "1",
"to" : "18612345678"
}
}
{
"resp" : {
"respCode" : "000000",
"failure" : 1,
"templateSMS" : {
"createDate" : 20140623185016,
"smsId" : "f96f79240e372587e9284cd580d8f953"
}
}
}
POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Messages/templateSMS?sig=7A685B0216D1CA6839C00C2BB18A109D
Host:api.ucpaas.com
Accept:application/xml
Content-Type:application/xml;
charset=utf-8 Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODQ4NDI=
POST /coolweb/voiceCode HTTP/1.1
Host: 172.16.10.32:8080
Content-Type:text/xml;charset=utf-8
Accept:application/xml
Content-Length: 461
**• 响应包体**
^属性 ^类型 ^约束 ^说明|
|retcode |int |必选 |返回错误码，0：成功，非0：失败 |
**• XML响应示例 **