这里会显示出您选择的修订版和当前版本之间的差别。
rest_api介绍及接入 [2016/12/24 07:55] admin [Rest API简介] |
rest_api介绍及接入 [2017/08/23 08:44] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ======Rest API介绍及接入====== | ||
- | |||
- | Ucpaas通讯开放平台提供**语音、短信、视频、IM**等通讯服务。当您计划在自有业务接入我们平台相关资源服务的同时,可以将Ucpaas认为是一个巨大的通讯(语音、视频、IM等)路由平台。 | ||
- | <html> | ||
- | <div style="background-color: #d9edf7;border-color: #fcfcfc;color:#636363;padding: 19px;"> | ||
- | |||
- | |||
- | 以短信为例:<br />平台主要为其他业务提供身份实时校验服务,例如您可以通过平台按身份校验需求下发文本或语音验证给相应的用户------我们将这种语音通讯场景称作:短信验证码或语音验证码。 | ||
- | </div> | ||
- | |||
- | </html> | ||
- | |||
- | 为方便不同行业的开发者理解和快速接入,我们将所有的通讯服务都提供一套 [[http://en.wikipedia.org/wiki/Representational_State_Transfer|Restful]] 的标准接口,基于这些接口开发者就只需要具备基本的HTTP协议知识背景,以及结合任何一门熟悉的开发语音,就可完成在现有业务的基础上完成集成通讯服务。 | ||
- | |||
- | 除了为开发者提供标准的Rest 接口,我们还针对不同平台提供SDK,您可以根据自己业务的需求,下载并集成相应的SDK快速开发 | ||
- | |||
- | * iOS SDK | ||
- | | ||
- | * Android SDK | ||
- | |||
- | * Windows SDK | ||
- | |||
- | * JS SDK (即将提供) | ||
- | |||
- | |||
- | 您可以浏览文档其他分页获取更多开发帮助。 | ||
- | |||
- | |||
- | |||
- | ===== Rest API简介 ===== | ||
- | |||
- | 注:Rest是一套新兴的web通讯协议,访问方式和普通的http类似,平台接口分get和post方式请求。 | ||
- | |||
- | 云之讯融合通讯开放平台rest 接口为第三方应用提供了简单易用的API调用服务,旨在为第三方开发者在应用内快速、高效、低成本集成云之讯的各项业务提供了一站式的服务。 | ||
- | |||
- | REST 协议支持**xml,json**两种请求方式,采用md5加密算法的方式,通过url参数的形式发送参数 | ||
- | |||
- | <html> | ||
- | <div style="background-color: #fcf8e3;border-color: #faebcc;color: #8a6d3b;padding: 19px;"> | ||
- | |||
- | |||
- | 注:目前rest版本号为<em style="color:red;"> 2014-06-30 </em>,该版本号为当前业务的固定版本号。 | ||
- | </div> | ||
- | </html> | ||
- | |||
- | REST API提供功能如下: | ||
- | <html> | ||
- | <div style="background-color: #d9edf7;border-color: #fcfcfc;color:#636363;padding: 19px;"> | ||
- | <ul><li> | ||
- | 1、<a href="doku.php?id=短信验证:rest_yz">短信</a> <br /> | ||
- | </li><li> | ||
- | 2、<a href="doku.php?id=语音验证:rest_kfzn_yyyz">语音验证码</a> <br /> | ||
- | </li><li> | ||
- | 3、<a href="doku.php?id=语音通知:home_yytz_kfzn">语音通知</a> <br /> | ||
- | </li><li> | ||
- | 4、<a href="doku.php?id=隐号通话:home_yyth">隐号通话</a> <br /> | ||
- | </li><li> | ||
- | 5、<a href="doku.php?id=呼叫中心:home">云呼叫中心</a> <br /> | ||
- | </li><li> | ||
- | 6、<a href="doku.php?id=client管理api">管理Client账号</a> <br /> | ||
- | </li><li> | ||
- | 7、<a href="doku.php?id=billlist_api&#请求">详单记录下载</a> <br /> | ||
- | </li> | ||
- | |||
- | <ul> | ||
- | |||
- | </div> | ||
- | |||
- | </html> | ||
- | |||
- | 在使用云之讯融合通讯开放平台REST API前,请您在云之讯官网注册账号,您将拥有一个主账户和若干Client,您可以通过Client管理客户信息以及控制用户使用情况。 | ||
- | |||
- | API是基于rest协议的,您可以使用几乎任何客户端在任何编程语言与REST API进行交互,以及编写和测试应用程序。 | ||
- | |||
- | ==== 开发环境要求 ==== | ||
- | |||
- | 不要求,可以支持任何语言 | ||
- | |||
- | ==== REST API的作用 ==== | ||
- | |||
- | * 创建子账号,用于客户端的接入 | ||
- | * 语音验证码 | ||
- | * 短信(短信验证码等) | ||
- | * 语音消息(发送任何法律范围内的文字用语音的形式播放) | ||
- | |||
- | ==== Base URL ==== | ||
- | |||
- | 文档中所有请求的URL地址都须加上如下Base URL: | ||
- | |||
- | <code java> | ||
- | https://api.ucpaas.com/{SoftVersion}/ | ||
- | </code> | ||
- | |||
- | 注意: 为了确保数据隐私和安全, REST API须通过HTTPS方式请求。 | ||
- | |||
- | ==== 统一请求包头 ==== | ||
- | |||
- | **请求URL格式** | ||
- | <code java> | ||
- | {SoftVersion}/Accounts/{AccountSid}/{function}/{operation}?sig={SigParameter} | ||
- | </code> | ||
- | |||
- | **HTTP标准包头字段(必填)** | ||
- | <code java> | ||
- | Accept:application/xml; | ||
- | Content-Type:application/xml;charset=utf-8; | ||
- | Content-Length:256; | ||
- | </code> | ||
- | |||
- | ==== 属性说明 ==== | ||
- | ---- | ||
- | |||
- | ^属性 ^类型 ^约束 ^说明 | | ||
- | |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 验证参数\\ | ||
- | * URL后必须带有sig参数,sig= MD5(账户Id + 账户授权令牌 + 时间戳),共32位(注:转成大写) | ||
- | * 使用MD5加密(账户Id + 账户授权令牌 + 时间戳),共32位 | ||
- | * 时间戳是当前系统时间(24小时制),格式"yyyyMMddHHmmss"。时间戳有效时间为50分钟。 | ||
- | |||
- | 3. Authorization是包头验证信息\\ | ||
- | * 使用Base64编码(账户Id + 冒号 + 时间戳) | ||
- | * 冒号为英文冒号 | ||
- | * 时间戳是当前系统时间(24小时制),格式"yyyyMMddHHmmss",需与SigParameter中时间戳相同。 | ||
- | |||
- | 4. function描述对应业务能力,operation描述业务能力的具体操作。 | ||
- | |||
- | 例如:/Calls/voiceCode | ||
- | |||
- | ==== 数据报文格式 ==== | ||
- | ---- | ||
- | |||
- | |||
- | REST API支持两种主流的报文格式:XML和JSON。 | ||
- | |||
- | 通过请求包头的字段Content-Type及Accept,即可决定请求包体和响应包体的格式,如: | ||
- | |||
- | <code java>Content-Type:application/xml;charset=utf-8;Accept:application/xml;</code> | ||
- | |||
- | 表示请求类型格式是XML,要求服务器响应的包体类型也是XML; | ||
- | |||
- | <code java>Content-Type:application/json;charset=utf-8;Accept:application/json;</code> | ||
- | |||
- | 表示请求类型格式是JSON,要求服务器响应类型也是JSON; | ||
- | |||