Demo 示例下载
请求地址
/{SoftVersion}/Accounts/{AccountSid}/{function}/{operation}?sig={SigParameter}
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
SoftVersion | String | 必选 | 云之讯REST API版本号,当前版本号为:2014-06-30 |
AccountSid | String | 必选 | 开发者账号ID。由32个英文字母和阿拉伯数字组成的开发者账号唯一标识符 |
SigParameter | String | 必选 | 请求URL必须带有此参数。 |
Accept | String | 必选 | 客户端响应接收数据格式:application/xml、application/json |
Content-Type | String | 必选 | 类型:application/xml;charset=utf-8、application/json;charset=utf-8 |
Authorization | String | 必选 | 验证信息。 |
function | String | 可选 | 业务功能。 |
operation | String | 可选 | 业务操作,业务功能的各类具体操作分支。 |
说明
1. SoftVersion是当前使用的REST API版本号,开发时须填写正确的版本号。
2. SigParameter是REST API验证参数
3. Authorization是包头验证信息
4. function描述对应业务能力,operation描述业务能力的具体操作。例如:/Calls/voiceCode
REST API支持两种主流的报文格式:XML和JSON。
通过请求包头的字段Content-Type及Accept,即可决定请求包体和响应包体的格式,如:
Content-Type:application/xml;charset=utf-8;Accept:application/xml;
表示请求类型格式是XML,要求服务器响应的包体类型也是XML;
Content-Type:application/json;charset=utf-8;Accept:application/json;
表示请求类型格式是JSON,要求服务器响应类型也是JSON;