Appearance
五、订单证件照片上传接口
5.1 接口请求
- 请求方式:Post
- 接收类型:form-data
- 说明:上传订单相关证件照片,仅支持Base64格式的jpg图片,单张图片大小限制为500KB。
5.2 接口地址
https://haokaopenapi.lot-ml.com/api/order/UpPicFile
5.3 请求参数
| 参数名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| user_id | String | Y | 代理在172号卡登录账号。 |
| Timestamp | String | Y | 时间戳(长度10位,且与服务器时间不能超过5分钟)。 |
| DownOrderNo | String | Y | 下游订单号(对接接口方订单号),不能重复。 |
| HeadImage | String | Y | 身份证正面照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。 |
| BackImage | String | Y | 身份证反面照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。 |
| FrontImage | String | Y | 上半身照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。 |
| user_sign | String | Y | md5加密,32位小写; 加密规则:Md5("BackImage=" + BackImage + "&DownOrderNo=" + DownOrderNo + "&FrontImage=" + FrontImage + "&HeadImage=" + HeadImage + "&Timestamp=" + Timestamp + "&user_id=" + user_id + secret) 注意:Java生成的MD5可能存在偏差,建议使用MD5在线加密工具 验证。 |
5.4 参数返回
5.4.1 成功返回
json
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "code"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"上传成功"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "errs"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>5.4.2、错误返回
json
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "code"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">-1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"签名错误"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "errs"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">null</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>