学历资质智能核验模型

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | Access-Id | string | 是 | 账号的 Access-Id | 对于业务请求参数 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`，以此方式进行传参。 ```json { "data": "xxxx(base64)" } ``` 对接响应得到的公共参数 ```json { "code": "int", "message": "string", "transaction_id": "string", // 流水号 "data": "string" } ``` **data** 字段为加密的数据，需要解密后查看。 ## 加密和解密机制 账户获得的密钥（**Access Key**）是一个 16 进制字符串，使用 AES-128 加密算法。 ### 加密过程： - 加密模式：**AES-CBC 模式**。 - 密钥长度：**128 位（16 字节）**。 - 填充方式：**PKCS7 填充**。 - **IV（初始化向量）**：IV 长度为 16 字节（128 位），每次加密时随机生成。 - 加密后，将 **IV** 和密文拼接在一起进行传输。 - 最后，将拼接了 IV 的密文通过 **Base64 编码**，方便在网络或文件中传输。 ### 解密过程： - 解密时，首先从 Base64 解码后的数据中提取前 16 字节作为 **IV**。 - 然后使用提取的 **IV**，通过 AES-CBC 模式解密剩余部分的密文。 - 解密后去除 **PKCS7 填充**，即可得到原始明文。

## 请求参数 ```json { "id_card": "string", "name": "string", "query_reason_id": "int" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | id_card | string | 是 | 身份证号 | | name | string | 是 | 姓名 | | query_reason_id | int | 是 | 查询原因 ID | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 公共返回参数 | 参数名称 | 参数描述 | 参数类型 | 备注 | |----------|----------|----------|------| | content | 数据内容 | json | 返回数据体 | | code | 状态码 | string | 请求返回的状态码 | | fee | 计费标识 | bool | 请求是否计费：1计费，0不计费 | | message | 错误信息 | string | 请求返回的状态码错误信息 | | requestId| 请求链路ID | string | 调用请求ID | | timeStamp| 时间戳 | long | 调用接口时间 | ## 业务返回参数 (content) | 参数名称 | 参数描述 | 参数类型 | 备注 | |----------|----------|----------|------| | hit | 是否命中 | string | 0-否 1-是 | | score | 风险评分 | int | - | ## 状态码 状态描述 | 状态码 | 状态描述 | |--------|----------| | 200 | 成功 | | 300000 | 请求参数（Headers）中必填参数缺失或值为空 | | 300001 | 请求参数解析出错 | | 300002 | 请求参数（Query）中必填参数缺失或值为空 | | 300003 | 签名验证失败，请检查您的签名计算方式和参数sign、signMode | | 300004 | 请求参数（授权参数）必填参数缺失或值为空 | | 300005 | 请求参数productCode、appKey校验不通过 | | 400000 | 账戶不存在 | | 400001 | appKey不存在 | | 400002 | 订单不存在 | | 400003 | 订单已停用 | | 400005 | 订单未到使用时间 | | 400006 | 订单配置缺失，请联系技术支持 | | 400007 | 订单次数用完 | | 400008 | 账戶余额不足 | | 400009 | 授信额度已用完 | | 400010 | 数据产品已停用 | | 400011 | 数据产品不存在 | | 400012 | 数据产品已失效 | | 400013 | 产品状态码信息不存在 | | 400014 | 状态码信息未就绪，请联系技术支持 | | 500001 | 不支持该加密方式 | | 500002 | 数据加解密异常，请联系技术支持 | | 500003 | 用戶未配置IP白名单 | | 500004 | 系统忙稍后再试 | | 500005 | 产品调用QPS超过订单约定上限 | | 500006 | 产品调用量超订单最大限制，请稍后再试 | | 500007 | 用戶限流 | | 500008 | 订单IP限流 | | 10016 | 动态加载jar包失败 | | 11000 | 中台调用超时 | | 10505 | 状态码映射异常 | | 30000 | 数据源查无 | | 30001 | 数据源异常 | | 30002 | 数据源访问超时 | | 30003 | 数据源访问出错 | | 30004 | 入参校验异常 | | 31007 | 敏感信息 | | 99999 | 技术类验证失败 | | 400015 | 数据产品暂不可用，请联系技术支持 | | 400016 | 产品未配置授权参数 | | 400017 | 没有查询到切源配置信息 | | 300006 | token不合法，校验不通过 | | 300007 | token已过期 | | 300008 | 辅助接口不存在或未授权 | | 300009 | 参数内容格式不正确 | | 300010 | 数据加载异常，请稍后重试或联系技术支持 | | 300011 | 文件大小超过限制 | | 500009 | 产品请求数据超出权限范围 | ## 分值说明（6类） | 分值 | 含义 | |------|------| | 0 | 未命中 | | 1 | 其它 | | 2 | 前科 | | 3 | 涉毒 | | 4 | 吸毒 | | 5 | 在逃 | | 6 | 涉案（包含在逃撤销） | ## 授权要求 - 上传编号，备查授权书 ## 应用场景 - 无限制

## 响应示例 ### 成功响应 ``` { "fee": null, "message": null, "code": null, "requestId": null, "timeStamp": null, "content": { "hit": "-", "score": "-" } } ```

## 错误代码 | code | message | |------|---------| | 0 | 业务成功 | | 1000 | 查询为空 | | 1001 | 接口异常 | | 1002 | 参数解密失败 | | 1003 | 基础参数校验不正确 | | 1004 | 未经授权的IP | | 1005 | 缺少Access-Id | | 1006 | 未经授权的AccessId | | 1007 | 账户余额不足，无法请求 | | 1008 | 未开通此产品 | | 2001 | 业务失败 |