自定义渠道接入

1.接口配置

使用管理者的权限登录一洽软件后，在设置-API接口页面中配置消息加解密秘钥和接收业务数据的URL
如图：
api配置

配置信息说明：

appId：一洽系统自动生成的应用唯一值，用于接口交互时判断用户身份。

encodingAesKey（消息加解密key)：由开发者手动填写或随机生成，将用作JSON/XML数据加解密密钥，为保证数据安全推荐使用密文方式传输数据。

Token：Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。

数据传输模式：明文：原始数据字符串 密文：通过AES加密过后的字符串

名词介绍：

apiServer：一洽提供给用户的接口服务器地址,例如：api.echatsoft.com

accessToken：调用一洽接口的授权令牌

ip白名单：允许访问一洽接口服务器的来源IP

2. 消息加解密说明

什么是EncodingAESKey？
一洽采用AES对称加密算法对消息体对行加密，EncodingAESKey则是加密所用的秘钥。消息接收方用此秘钥对收到的密文消息体进行解密。

消息加解密过程和微信公众平台的消息加解密方式一致。
示例代码（包括C++、php、Java、Python和C#版本）示例代码
注：一洽的签名信息在GET请求中，微信的示例代码签名在XML结构中，Encrypt节点的加解密方式是一样的。

Java要求jdk 1.6及1.6以上
异常java.security.InvalidKeyException:illegal Key Size的解决方案：在官方网站下载JCE无限制权限策略文件（请到官网下载对应的版本， 例如JDK7的下载地址：http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html 下载后解压，可以看到local_policy.jar和US_export_policy.jar以及readme.txt，如果安装了JRE，将两个jar文件放到%JRE_HOME%\lib\security目录下覆盖原来的文件；如果安装了JDK，将两个jar文件放到%JDK_HOME%\jre\lib\security目录下覆盖原来文件

3. 根据接口文档实现业务逻辑

一洽业务API是提供给用户以HTTP的方式不定期的通过接口来获取以及修改一洽相关的业务数据（对话、留言、客服信息、路由、实时状态等），一洽客服系统业务API的使用流程大致如下：