快货运Open Api

# 提交实名认证信息

接口名称：/realName/submit

请求参数

序号 层级 英文名称 中文名称 类型 长度 必填 说明
1 1 realName 姓名 String 20 是 2-20 个汉字(少数民族符号 · )
2 1 idCard 身份证号码 String 18 是 18 位数字（末尾允许输入 X），符合身份证号校验算法
3 1 address 身份证住址 String 255 是
4 1 idCardStartDate 身份证有效开始日期 Long 否 时间戳，精确到毫秒。有效期跨度需为 5 年、10 年、20 年和长期(46 周岁以上)四种；长期证件，有效期填 2199 年 12 月 31 日
5 1 idCardEndDate 身份证有效结束日期 Long 否
6 1 nation 民族 String 20 否 民族
7 1 gender 性别 Integer 4 否 性别：1-男 2-女
8 1 birthday 出生日期 Long 否 出生日期
9 1 idCardIssueOrganization 身份证发证机关 String 30 否 不超过 30 个汉字
10 1 idCardFrontFilename 身份证正面照 Filename String 255 是 使用文件上传接口返回的地址
11 1 idCardBackFilename 身份证背面照 Filename String 255 是 使用文件上传接口返回的地址
12 1 selfImageFilename 自拍照片 Filename String 255 是 使用文件上传接口返回的地址

示例

{
  "address": "string",
  "birthday": 1480262400000,
  "gender": 0,
  "idCard": "string",
  "idCardBackFilename": "string",
  "idCardEndDate": 1480262400000,
  "idCardFrontFilename": "string",
  "idCardIssueOrganization": "string",
  "idCardStartDate": 1480262400000,
  "nation": "string",
  "realName": "string",
  "selfImageFilename": "string"
}

返回参数

true

mock 数据示例

{
  "code": "00000",
  "data": true,
  "message": "请求成功"
}

# 根据身份证号查询实名信息

接口名称：/realName/queryByIdCard

请求参数

类型 名称 备注 必填
List*<String>* idCards 身份证号集合 是

返回参数

类型 名称 备注
Long id 司机 ID
Long userId 用户 ID
String realName 姓名
String idCard 身份证号码
String address 身份证住址
String idCardFrontFilename 身份证正面照 Filename
String idCardBackFilename 身份证背面照 Filename
String selfImageFilename 自拍照片 Filename
String gender 性别：1-男 2-女
String nation 民族
String birthday 出生日期
Integer realStatus 实名认证状态： 1-通过,0-失败
Long idCardStartDate 身份证有效开始日期
Long idCardEndDate 身份证有效结束日期
String idCardIssueOrganization 身份证发证机关
String refuseReason 审核拒绝原因

mock 数据示例

{
  "code": "00000",
  "data": [
    {
      "id": 1,
      "userId": 1,
      "realName": "String",
      "phone": "String",
      "idCard": "String",
      "address": "String",
      "idCardFrontFilename": "String",
      "idCardBackFilename": "String",
      "selfImageFilename": "String",
      "gender": 1,
      "nation": "String",
      "birthday": 2111414400000,
      "realStatus": 1,
      "idCardStartDate": 1480262400000,
      "idCardEndDate": 2111414400000,
      "idCardIssueOrganization": "String",
      "refuseReason": null
    }
  ],
  "message": "请求成功"
}

# 根据身份证号查询实名信息

接口名称：/realName/queryByUserId

请求参数

类型 名称 备注 必填
[long] idList 用户 ID 集合 是

返回参数

类型 名称 备注
Long id 司机 ID
Long userId 用户 ID
String realName 姓名
String idCard 身份证号码
String address 身份证住址
String idCardFrontFilename 身份证正面照 Filename
String idCardBackFilename 身份证背面照 Filename
String selfImageFilename 自拍照片 Filename
String gender 性别：1-男 2-女
String nation 民族
String birthday 出生日期
Integer realStatus 实名认证状态： 1-通过,0-失败
Long idCardStartDate 身份证有效开始日期
Long idCardEndDate 身份证有效结束日期
String idCardIssueOrganization 身份证发证机关
String refuseReason 审核拒绝原因

mock 数据示例

{
  "code": "00000",
  "data": [
    {
      "id": 1,
      "userId": 1,
      "realName": "String",
      "phone": "String",
      "idCard": "String",
      "address": "String",
      "idCardFrontFilename": "String",
      "idCardBackFilename": "String",
      "selfImageFilename": "String",
      "gender": 1,
      "nation": "String",
      "birthday": 2111414400000,
      "realStatus": 1,
      "idCardStartDate": 1480262400000,
      "idCardEndDate": 2111414400000,
      "idCardIssueOrganization": "String",
      "refuseReason": null
    }
  ],
  "message": "请求成功"
}

← 运单 →