指引

# 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对象。