回调接入指南
一、接入必读
“设置-系统对接”页面完成 消息校验token、消息加解密key、消息与事件接受URL、调用数据加解密 四个参数的配置；2、如暂时不确定对SCRM系统发起请求的服务器出口IP或者其他情况，可先设置为
0.0.0.0调试,后期根据第三方系统的实际情况进行调整；3、OpenAPI进行新增和编辑等操作不会触发对应事件变更回调
二、配置回调URL、加密参数
"searchs"等关键字作为回调地址路径的一部分，回调地址URL需同时支持GET和POST请求；配置或更新回调地址时，尘锋SCRM会对目标回调地址发起一次GET请求，第三方系统需按照《三、URL配置校验（GET请求）》对请求进行正确的解密处理并返回要求内容才可以通过校验；2、
GET请求用于验证秘文解密逻辑是否被正确实现，SCRM系统回调该接口时，第三方系统需要对推送的秘文进行解密并返回解密后的明文，返回示例参考：《三、URL配置校验（GET请求）- 3、三方系统-URL配置校验解密返回示例》；3、
POST请求用于后续验证推送内容时是否正确被接收，接收到请求后返回指定结构体即可。返回示例参考：《四、尘锋系统变更事件推送（POST请求）- 3、三方系统事件接收响应内容示例》；三、URL配置校验（GET请求）
1、尘锋SCRM-URL配置校验加密请求示例
下列代码仅展示示例，并不能用作调试使用，请使用您公司尘锋账户的相关参数进行调试
2、三方系统-URL配置校验解密示例
解密所需SDK点击这里跳转3、三方系统-URL配置校验解密返回示例
Content-Type:text/plain，另外切勿额外携带 "" 包装返回内容；4、异常处理
四、尘锋系统变更事件推送（POST请求）
1、尘锋推送 加密请求示例
type⽀持的值：add(新增客户)/del(删除客户)/update(客户更新)。 三⽅拿到客户id(cus_ids)后调⽤拉取接⼝获取客户的全量信息进⾏数据同步。
event代表事件分类，⽬前仅⽀持customer。 2、删除客户的情况del_reason包括三种值：ordinaryDel（普通客户删除），userDel（员⼯删除外部联系⼈），externalDel（外部联系⼈ 删除员⼯）
2、三方系统解密后完整body示例
解密所需SDK点击这里跳转您可以根据我们传递的
type自行规划业务逻辑3、三方系统事件接收响应内容示例
数据类型为
int成功返回：1
失败返回：0
{
"code" : 1
}2、切勿在回调处理逻辑内增加额外业务处理逻辑，避免延长响应时间，当推送事件较频繁时，可能会导致接口请求超时。
3、推送限制：多次响应超时、服务器⽆响应、多次响应失败，10分钟内达到100次，推送接⼝将降低所有推送事件频率为3⼩时⼀次。
五、加密SDK（自测）
BizMsgCrypt.EncryptMsg(String replyMst)将数据加密并推送给您，您也可以通过此函数自行校验；加密所需参数以您在尘锋系统里获取到的为准。
六、三方系统-接口处理代码示例
Q1：处理GET请求时为什么要将" "全量替换为"+"?
Q2：java.security.InvalidKeyException: Illegal key size
解决方案JCE无限制权限策略文件Q3：commons-codec依赖
Exception in thread "main" java.lang.IllegalArgumentException: Last encoded character (before the paddings if any) is a valid base 64 alphabet but not a possible value
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.15</version>
</dependency>