接口说明

• 介绍

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 为隐藏数据
   •  冒号为英文冒号

• 返回值说明