接口地址
生产环境:https://syb-batch.allinpay.com/sybupfile
测试环境:https://syb-test.allinpay.com/sybupfile
使用场景:
商户进件前可通过该接口先将图片文件上传通联服务器,然后根据返回的token替换url操作进件
备注:
首次使用前必须先联系通联方申请
上传文件频率限制1秒1次
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
代理商号 |
代理商号 |
否 |
15 |
|
cusid |
商户号 |
商户号 |
否 |
15 |
与orgid一致 |
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
signtype |
签名类型 |
RSA/SM2 |
可 |
32 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
filetype |
文件类型 |
支持格式:png、jpg、zip. |
否 |
15 |
|
filecontent |
图片二进制字节流 Byte_array |
文件二进制字节流, Zip 最大为5M Png,jpg 最大为2M |
否 |
5,191,680 |
文件流不参与签名 |
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 FAIL-请求或前端处理失败,具体看retmsg |
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
token |
文件标识, 在进件时对应字段传入 |
20200509010bp4-kD9SACI |
否 |
22 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |