实名认证
<p><strong>简要描述:</strong> </p>
<ul>
<li>提交实名认证</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/v1/user/real-name</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">是否必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">truename</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>真实姓名</td>
</tr>
<tr>
<td style="text-align: left;">idcard</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>身份证号码</td>
</tr>
</tbody>
</table>
<p><strong>身份验证: </strong></p>
<p><code>是</code></p>
<p><strong>返回示例</strong></p>
<pre><code># 成功
{
&quot;code&quot;: 0,
&quot;message&quot;: &quot;认证成功&quot;,
&quot;data&quot;: {
&quot;status&quot;: 4
}
}
{
&quot;code&quot;: 0,
&quot;message&quot;: &quot;实名认证已提交审核, 请耐心等待&quot;,
&quot;data&quot;: {
&quot;status&quot;: 1
}
}
# 异常
{
&quot;code&quot;: 422,
&quot;message&quot;:&quot;实名认证失败, 请检查&quot;,
&quot;data&quot;: {
&quot;status&quot;: 2
}
}</code></pre>
<p><strong>备注</strong></p>
<p>建议客户端直接提示 <code>message</code> 字段, 反馈用户结果.</p>