指引
# 1. 链接中涉及参数释意
MSG_ROOT_PATH:短信服务器基础路径
AOD_ROOT_PATH: 自动外呼服务基础路径
MKT_ROOT_PATH: 人工外呼服务基础路径
NOTIFY_PATH:第三方系统回调基础地址(采用http/https协议,不支持双向认证的https)
# 2. 系统认证
>w 第三方系统接入前,需在客服系统配置第三方系统信息
请求客服中心接口(或客服中心发送通知),需提供请求签证(加解密RSA/ECB/PKCS1Padding,签名SHA1withRSA,密钥长度1024)。
签证生成分为以下步骤:
1. 使用对端系统公钥对 ApiKey+系统编码+请求时间 加密
2. 使用服务器私钥对 1产生的密文生成签名
3. 组合 base64(1).base64(2)
>i 请求时间,请求验签随机数,请求签证,请求系统编号通过请求头携带(接口文档不再标注)
X-Api-Key: apiKey
X-Request-Date: 请求时间(yyyyMMddHHmmss), 请求时间与实际请求到达时间偏差不得超过5分钟。
Authorization:签证
>i 客服系统系统编码为 CC,客服系统apiKey使用第三方系统apiKey
2. 签证样例
系统编码 KT_001 ApiKey: 1H8asM3F 请求时间:20211207112800
公钥:
```
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCtfyhDSuinAFVJDTB42+gA2pr2iHH3Cf4srgV+jYeWuCGELkdW7wl+/NHVSL3CJ8ObsPD16u8rbINn7Ul/SQeGiL3Y4vygmnxPFB0gWVBCQB7yE5IJYCkFEl+bZKvA6P22ZSOSU0Xbajfv/UA1A36mlTlYjEIo2wE92aVU97nL1wIDAQAB
```
私钥:
```
MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAK1/KENK6KcAVUkNMHjb6ADamvaIcfcJ/iyuBX6Nh5a4IYQuR1bvCX780dVIvcInw5uw8PXq7ytsg2ftSX9JB4aIvdji/KCafE8UHSBZUEJAHvITkglgKQUSX5tkq8Do/bZlI5JTRdtqN+/9QDUDfqaVOViMQijbAT3ZpVT3ucvXAgMBAAECgYBpRIHVcpn+2gDlNg93BVabTghAFUGwtmt2CJBk3NKr7ETJwpqecKK+Xf+i/WPFbgMNcCqDy2waWNjSMfMqO9FIG9SmddpBNcKQbXki9Tc9KGW0WQshB3QkqA4FYMYKH3xMd0NJa2tmS78rbBn1CkmgxL1o1i/s3mp+gqHDW7u2YQJBANgYkGcE/NMwhcjFy851VRU1rq3GKwpk5lDHja1g4XV1tuHS3/zzl7zcjE1tNPfVRCF2iXi2semnL/yCVl545QMCQQDNiNAAJb3kD/np6VdIYBMNEm+R/XQQ30MQr8miuG2/Jiqzpzf/gZxzGL+ta5/i4RD7y1/HcWJM520jg9Wx53OdAkEAt6/Jr4hR0MMCNbPMlmauOCU1ook8tM0n6ap3B9W+UDYLitHRjBcT+HoQ2Q/nYnNqQnecS3wgp1hyNdYkzJE/OQJBAIpWzqF6xcAOXMjrLLtjJw+CXCQoMwn0LAC8QPxMJFonR1CaeZ95TqNNgh4otXoQwMypi3MDRwW6MwRXhOr0fSUCQQDCC1Nbreyr/YcLkDCBfKHyq54Zi/RKbAYUGTed9GK6j/U/+Nh6prem6+ev/zYcfhkFpqGHMrKuzcJxWNA04DzX
```
最终生成证书:
```
QBase lqFpbsbuOiLeiyxAuC1ny71DW54jTjZRrFPZFTJ/L93QDpWPO6uQS0IpuKFJogEQk48K698cQ6p9QDEcVu97/fdrgSvbDsmGxbI/CKhOPUu75sjdei4DBov+sTXz1WQt0oyW3fLLqFhQUFGBaLFd4xXy9Dw3OoUlGbKDV8H8/E4=.VhUJ0NqAEl4lV4m20JRgoIpuOUr8Z1+u+kfdm2wzKNSzQpsFpDQYoxS0CX7IW+5IQQ5fwg65V6efvZcCnY/WsI4gAPy1e4wEGXShsd/ITlQgUOg0ISWCYDK5n7QrUojvvKbuDtgTe7DxLRbpy6eNCESV9h7kz9TWf/49PxTtPvE=
```
# 3. 系统返回信息
由客服系统返回的信息除特殊格式外均为json格式
```json
{
"status": "0000",
"message": "",
"data": any
}
```
status: 请求返回状态,参照异常码,0000表示成功
message:请求补充消息
data: 接口返回数据,具体依据接口定
# 4.关于数据类型
数据名称为 [] 表示直接为json数组数据,无需最外层(例如参数只有[]时,请求body中直接为json数组)
数据名称为{}表示直接为json对象,无需最外层(此为默认设置,不直接标明)。
URL参数表示url中需替换的参数
对于GET请求,请求参数中说明的参数应当附带在链接中:?id=xx&name=xxx
除GET请求外,请求参数中说明的参数应当在body域中,无特殊说明均为json对象。