学历查询
<h3>接口描述</h3>
<ul>
<li>输入姓名、身份证号和证书编号，返回学历信息</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/education/query</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>是否必填</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>客户唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，详见：签名算法说明</td>
</tr>
<tr>
<td>name</td>
<td>String</td>
<td>是</td>
<td>姓名</td>
</tr>
<tr>
<td>idcard</td>
<td>String</td>
<td>是</td>
<td>身份证号</td>
</tr>
<tr>
<td>certificateNo</td>
<td>String</td>
<td>是</td>
<td>证书编号</td>
</tr>
</tbody>
</table>
<h4>签名算法</h4>
<pre><code>sign = sha256(appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 <strong>appId</strong>、服务商分配的 <strong>appSecret</strong>，当前时间毫秒数 <strong>timestamp</strong>，按上述顺序拼接成字符串，再进行 <strong>sha256</strong> 哈希得到。如下：</p>
<pre><code class="language-java">String appId = "xyzxy2121zxyz"；
String timestamp = "1555378976238"；
String appSecret = "efcefcef1121cefcefc1212121"；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>正确返回样例</h3>
<pre><code>// 有结果
{
"code": 200,
"taskNo": "074388502348792558",
"charge":true,
"data": {
"result": 0,
"desc": "查询成功，有数据",
"education": {
"name": "李世民",
"sex": "男",
"birthday": "1982年04月07日",
"enrollment_date": "2007年09月01日",
"graduation_date": "2007年12月20日",
"school": "浙江理工大学",
"specialty": "国际贸易学",
"type": "普通高等教育",
"duration": "*",
"study_type": "全日制",
"level": "本科",
"situation": "毕业",
"principal": "*",
"cer_no": "104971200502001123"
}
}
}
// 无结果
{
"code": 200,
"taskNo": "074388502348792558",
"charge":true,
"data": {
"result": 1,
"desc": "查询成功，无数据"
}
}</code></pre>
<h3>错误返回样例</h3>
<pre><code>{
"msg": "入参错误",
"code": 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见：<strong>code返回码说明</strong></td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志 true - 计费，false - 不计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data.result</td>
<td>0:查询成功有数据；1:查询成功无数据</td>
</tr>
<tr>
<td>data.desc</td>
<td>查询结果描述</td>
</tr>
<tr>
<td>data.education</td>
<td>返回学历信息，详见：education字段详细说明</td>
</tr>
</tbody>
</table>
<blockquote>
<p>计费规则，code=200计费，其余code不计费</p>
</blockquote>
<h3>education 字段详细说明</h3>
<table>
<thead>
<tr>
<th>参数名</th>
<th>参数描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>姓名</td>
</tr>
<tr>
<td>sex</td>
<td>性别</td>
</tr>
<tr>
<td>birthday</td>
<td>生日</td>
</tr>
<tr>
<td>enrollment_date</td>
<td>入学日期</td>
</tr>
<tr>
<td>graduation_date</td>
<td>毕（结）业日期</td>
</tr>
<tr>
<td>school</td>
<td>学校名称</td>
</tr>
<tr>
<td>specialty</td>
<td>专业</td>
</tr>
<tr>
<td>type</td>
<td>学历类别</td>
</tr>
<tr>
<td>duration</td>
<td>学制</td>
</tr>
<tr>
<td>study_type</td>
<td>学习形式</td>
</tr>
<tr>
<td>level</td>
<td>层次</td>
</tr>
<tr>
<td>situation</td>
<td>毕（结）业</td>
</tr>
<tr>
<td>principal</td>
<td>校（院）长名称</td>
</tr>
<tr>
<td>cer_no</td>
<td>证书编号</td>
</tr>
</tbody>
</table>
<h3>code 返回码说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功 （计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>