Skip to content

五、订单证件照片上传接口

5.1 接口请求

  • 请求方式:Post
  • 接收类型:form-data
  • 说明:上传订单相关证件照片,仅支持Base64格式的jpg图片,单张图片大小限制为500KB。

5.2 接口地址

https://haokaopenapi.lot-ml.com/api/order/UpPicFile

5.3 请求参数

参数名称类型是否必填说明
user_idStringY代理在172号卡登录账号。
TimestampStringY时间戳(长度10位,且与服务器时间不能超过5分钟)。
DownOrderNoStringY下游订单号(对接接口方订单号),不能重复。
HeadImageStringY身份证正面照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。
BackImageStringY身份证反面照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。
FrontImageStringY上半身照片,Base64格式,需加前缀 data:image/jpeg;base64, 。大小≤500KB。
user_signStringYmd5加密,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;">"&#x4E0A;&#x4F20;&#x6210;&#x529F;"</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;">"&#x7B7E;&#x540D;&#x9519;&#x8BEF;"</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>