学历证书查询（diploma）
<p>[TOC]</p>
<h5>产品描述</h5>
<ul>
<li>通过姓名、身份证号、学历证书编号，返回学历信息，包括：学校名称、专业、学历类别、入学日期、毕（结）业日期等。</li>
</ul>
<h5>接口地址</h5>
<ul>
<li>请求地址：<code>https://api.caih.com/verify/api/diploma</code></li>
<li>请求方式：POST</li>
<li>接口数据类型：JSON</li>
<li>编码方式：UTF-8</li>
<li>接口参数传递位置：请求体body</li>
<li>接口参数传递内容：认证信息参数（authinfo）和校验请求参数（param）</li>
</ul>
<h5>接口须知</h5>
<ul>
<li><strong>认证信息参数</strong> 和 <strong>统一响应参数</strong>请查看页面 <a href="https://www.showdoc.cc/p/52021eddfd9994a7b84d891a16e27f66" title="认证信息参数和统一响应参数">认证信息参数和统一响应参数</a></li>
<li>如需加密对接请查看页面 <a href="https://www.showdoc.cc/p/dfff667dec3c68748dddde67674eb993" title="加密对接说明">加密对接说明</a>，并联系运营人员进行配置</li>
</ul>
<h5>校验请求参数（param）</h5>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>name</td>
<td>是</td>
<td>string</td>
<td>姓名（长度2~100，内容无限制，中文姓名不能包含空格）</td>
</tr>
<tr>
<td>idcode</td>
<td>是</td>
<td>string</td>
<td>身份证号，18位</td>
</tr>
<tr>
<td>certificateNumber</td>
<td>是</td>
<td>string</td>
<td>证书编号，17或18个数字</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
(认证信息参数)
"param": {
"name": "小明",
"idcode": "412825199412252999",
"certificateNumber": "101905201605222222"
}
}</code></pre>
<h5>产品响应参数（data）</h5>
<p>验真状态码及描述请查看本页章节 <code>验真状态码及描述</code> 。</p>
<table>
<thead>
<tr>
<th>参数名</th>
<th>是否必填</th>
<th>类型</th>
<th><div style="width: 400px"/>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>state</td>
<td>是</td>
<td>string</td>
<td>验真状态码</td>
</tr>
<tr>
<td>desc</td>
<td>是</td>
<td>string</td>
<td>验真状态码描述</td>
</tr>
<tr>
<td>name</td>
<td>否</td>
<td>string</td>
<td>姓名</td>
</tr>
<tr>
<td>sex</td>
<td>否</td>
<td>string</td>
<td>性别</td>
</tr>
<tr>
<td>birthday</td>
<td>否</td>
<td>string</td>
<td>生日，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>enrollmentDate</td>
<td>否</td>
<td>string</td>
<td>入学日期，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>graduationDate</td>
<td>否</td>
<td>string</td>
<td>毕（结）业日期，格式：yyyy-MM-dd</td>
</tr>
<tr>
<td>school</td>
<td>否</td>
<td>string</td>
<td>学校名称</td>
</tr>
<tr>
<td>specialty</td>
<td>否</td>
<td>string</td>
<td>专业</td>
</tr>
<tr>
<td>type</td>
<td>否</td>
<td>string</td>
<td>学历类别</td>
</tr>
<tr>
<td>duration</td>
<td>否</td>
<td>string</td>
<td>学制</td>
</tr>
<tr>
<td>studyType</td>
<td>否</td>
<td>string</td>
<td>学习形式</td>
</tr>
<tr>
<td>level</td>
<td>否</td>
<td>string</td>
<td>层次</td>
</tr>
<tr>
<td>situation</td>
<td>否</td>
<td>string</td>
<td>毕（结）业</td>
</tr>
<tr>
<td>principal</td>
<td>否</td>
<td>string</td>
<td>校（院）长名称</td>
</tr>
<tr>
<td>minorSchool</td>
<td>否</td>
<td>string</td>
<td>辅修学校</td>
</tr>
<tr>
<td>minorSpecialty</td>
<td>否</td>
<td>string</td>
<td>辅修专业</td>
</tr>
<tr>
<td>minorIssuanceDate</td>
<td>否</td>
<td>string</td>
<td>发证日期</td>
</tr>
<tr>
<td>minorStartEndDate</td>
<td>否</td>
<td>string</td>
<td>起止日期</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<h6>查询成功</h6>
<pre><code>{
(统一响应参数)
"data": {
"state":"1",
"desc":"查询成功有数据",
"name":"小明",
"sex":"男",
"birthday":"1994-04-22",
"enrollmentDate":"2013-01-10",
"graduationDate":"2018-01-05",
"school":"长春工业大学",
"specialty":"土木工程",
"type":"成人高等教育",
"duration":"5",
"studyType":"函授",
"level":"本科",
"situation":"毕业",
"principal":"小红",
"minorSchool":"长春工业大学",
"minorSpecialty":"软件工程",
"minorIssuanceDate":"2018-01-05",
"minorStartEndDate":"2013-01-10"
}
}</code></pre>
<h6>查询失败</h6>
<pre><code>{
(统一响应参数)
"data": {
"state": "0",
"desc": "失败"
}
}</code></pre>
<h5>验真状态码及描述</h5>
<table>
<thead>
<tr>
<th>验真状态码（state）</th>
<th>验真状态码描述（desc）</th>
<th>是否收费</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>失败</td>
<td>否</td>
</tr>
<tr>
<td>1</td>
<td>查询成功有数据</td>
<td>是</td>
<td>仅该情况有其他响应参数</td>
</tr>
<tr>
<td>2</td>
<td>查询成功无数据</td>
<td>是</td>
<td>校验请求参数不匹配时，可能返回该状态</td>
</tr>
</tbody>
</table>
<p>优先使用姓名+证书编号查询，若结果信息不全，会补充身份证号查询，并检查姓名和身份证号是否一致，不一致会返回查询成功无数据
只有拥有辅修专业证书时，辅修专业相关的四个字段才有值，否则为空字符串
信息不全：之前留的毕业证上面没有头像、学校等信息缺失</p>