“首页”的版本间的差异

2016年4月25日 (一) 13:55的最新版本

• 介绍

UUCALL 云呼叫中心平台 REST API 接口是为企业用户提供CTI管理、接口拨号、语音插件管理、CRM管理、帐号权限管理、账户信息、文件管理等模块功能的外部控制及数据交互的接口支持。API是基于REST原则上的，所以它很容易编写和测试应用程序。您可以使用浏览器访问URL，也可以使用几乎任何客户端在任何编程语言与REST API进行交互。

• Base URL

所有被引用的地址都有如下Base URL:

沙盒地址，用于应用上线前进行业务测试的Base URL：https://cloud.uucall.cloopen.com:8883

生产地址，用于应用上线后进行正式业务的Base URL：https://cloud.uucall.cn:3888



注意：平台的REST API是通过HTTP方式请求。

• 统一请求包头

URL格式：rest/{path}

注意：在URL格式中rest为固定内容，{}内的内容表示为实际接口的路径。

HTTP标准包头字段说明(必填)

Accept:text/xml;

Content-Type:text/xml;charset=utf-8;
 
Content-Length:256;

appid:XXXX

timestamp:2016-03-11 00:00:00

Authorization:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX


HTTP包头属性说明

appid: 对应模块应用id，具体详见appid获取接口说明

timestamp: 请求时间戳格式 yyyy-MM-dd HH:mm:ss

Authorization: 验证信息，生成规则详见下方详细说明

• 字段详细说明

1. appid 获取接口

   • Accounts：主帐号鉴权，云通讯平台会对请求中的主帐号和主帐号Token进行验证。

   • SubAccounts：子帐号鉴权，云通讯平台会对请求中的子帐号和子帐号Token进行验证。


2. SigParameter 鉴权参数

   •  SigParameter是隐藏参数，参与到 Authorization 的校验运算规则当中。

   •  使用MD5加密（apikey+":"+extras+":"+timestamp）。其中apikey为企业授权接口密匙，需要接口使用者向UUCALL项目团队获取。
    
   •  时间戳是当前系统时间，格式"yyyy-MM-dd HH:mm:ss"。时间戳有效时间为24小时，如：2014-04-16 14:20:30，且必须与HTTP字段时间戳一致。

   •  所生成的 SigParameter参数为32位大写MD5值。


3. Authorization 包头验证信息

   •  使用Base64编码（userName + 英文冒号 + SigParameter），其中 SigParameter 为隐藏数据。

   •  冒号为英文冒号。

• 返回值说明
  

• 数据报文格式

平台REST接口支持主流的报文格式：JSON。 

• 关于REST (REpresentational State Transfer)</br>

REST的客户端服务器分离理念大大简化了组件执行，降低了语义间连接的复杂度，改进了性能调整的有效性，增加了服务器组件的可扩展性。分层的结构化系统约束允许在不改变接口的情况下引入中间代理、网关、防火墙等多种接入点，并与之通讯，并且通过可扩展性，以共享内存的方式改进系统性能，有助于信息传递。通过对消息的约束，把REST的中间处理变为一个独立的自我描述：无状态交互，使用标准的方法和媒体类型。通过这种方式使语义信息，交互数据，响应信息能够明确的显示其使用缓存的能力。

REST设计原则

1. 应用场景和功能都被分为不同的资源

2. 每一个资源通过一个全局的资源标识以超链接的方式被访问

3. 所有资源通过共享标准的接口实现客户侧和资源之间的场景转换，资源包括如下两项：

   • 已经被定义好的一套有约束的操作集。

   • 一套有约束的内容类别集和可选的命令支持码。


REST 协议特点

   • 客户侧请求服务器模式

   • 状态无关

   • 缓存机制

   • 层次结构