IP白名单 | 本系统具有IP白名单限制,需要先请确认自身服务器公网IP已由羽山数据运维工程师加入 |
协议 | HTTP/HTTPS POST |
编码格式 | UTF8 |
HEAD: ACCT_ID | 必填,开户后将获得接入账号APP_ID,如“test_user” |
HEAD: CONTENT-TYPE | application/json |
测试环境URL | http://122.152.195.249:21000/credit-gw/service |
生产环境URL | https://api.yushanshuju.com/credit-gw/service |
明文Request JSON样例 | {
"prod_id": "TRA001",
"req_data": {
这里是业务入参
},
"req_time": 1545270159122,
"request_sn": "4df1e3c9583d40a9a57f63e4ab153189"
} |
明文Request JSON样例说明 | prod_id 为产品编号。req_data 为业务入参,请参考下面详细信息。 req_time 为Linux 毫秒时间,可使用echo `date +%s`"000" 命令获得最新时间。request_sn为请求单号,不可重复,需自行生成。 |
明文Response JSON样例 | {
"response_sn": "20190602020740639KIBG",
"retdata": {
"final_auth_result": "1" },
"version": "1.0",
"request_sn": "4a5f3f52e5324a87b96e16c0585",
"retmsg": "交易成功",
"retdate": 1559412461182,
"retcode": "000000"
} |
明文Response JSON样例说明 | response_sn 返回单号。 retdata 返回业务json。 retmsg 返回描述。 retcode 系统代码。 |
技术支持 | 13764219628 阿南 |
私钥 | 登录系统或联系技术支持获得接入KEY,加密JSON Request 和解密response密文时需要使用。注意要严格保密使用,请勿外泄,如有遗失,自行负责! |
请求报文加密算法 | 将request JSON明文aes-128-cbc 加密后base64编码,随后POST提交. |
接收报文解密算法 | 将response JSON使用base64解码后,aes-128-cbc解密为明文. |
加解密样例(Linux 命令) | ##加密命令实现
echo -n '{"prod_id":"P_C_B008","req_data":{"cardNo":"120105198504090312","name":"刘北"},
"req_time":1545270159122,"request_sn":"4df1e3c9583d40a9a57f63e4ab153189"}' |
openssl aes-128-cbc -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 |base64 -w 0
##解密命令实现
echo -n 'lQCG4JX7L0VwyAMBP7v05DwqdgVRiKEp6ExdIvlyCVpvDCSc671 csbiSsLIsORrJVXVvuAPKKYhPKeJhe6XYolGa6VvfXK7irFcohKmcMVxokNba1+ o4GQkjMXxQdVC1Lqx2Q9XeVS2pGcFrzJKlOHRt7yJWVahURpEmXL8IA2d ozEhrG5bBnWc3jTZYO50OQBH0jCOsjRE8q5qI5UQCA42gNposviVrVfcnZJRqqyrvVW kOGF8uqc57sKLzVVzgvdTZuoHWWwoyPmKUXq9dNw==' | base64 -d |
openssl aes-128-cbc -d -K 8f781ee51319e00535de09525af6068b -iv 30303030303030303030303030303030 -p |
request_sn | 请求序列号 |
acct_id | 账号 |
prod_id | 产品ID |
req_data | 传入参数 |
req_time | 请求时间 |
response_sn | 返回单号 |
retdata | 返回参数 |
retcode | 返回代码 |
retmsg | 返回信息 |
retdate | 返回时间戳 |