<h2>1.接口描述</h2>接口请求域名： <code>https://tianyu.yunaq.com</code> 验证姓名、身份证⼀致性结果。接口地址：/api/v1/tianyu/query-idCardAuth<h2>2.输入参数</h2>以下所有参数在入参时，请正确传参，不能传入空值。五选二字段为基本字段，要求至少选择两项。其余参数请查看<a href="https://www.yunaq.com/help/article?id=5f59d440a83eed0011d4c0a6">公共参数</a>部分。<table ><tr><td colSpan="1" rowSpan="1">参数名称</td><td colSpan="1" rowSpan="1">必 选</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">Action</td><td colSpan="1" rowSpan="1">是</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">公共参数，本接⼝取值：BspIdCardAuth。</td></tr><tr><td colSpan="1" rowSpan="1">Version</td><td colSpan="1" rowSpan="1">是</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">公共参数，本接⼝取值：2019-05-21。</td></tr><tr><td colSpan="1" rowSpan="1">Region</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">公共参数，本接⼝不需要传递此参数。</td></tr><tr><td colSpan="1" rowSpan="1">Name</td><td colSpan="1" rowSpan="1">是</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">姓名</td></tr><tr><td colSpan="1" rowSpan="1">IdNumber</td><td colSpan="1" rowSpan="1">是</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">身份证号</td></tr><tr><td colSpan="1" rowSpan="1">OpenId</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；微信opneId</td></tr><tr><td colSpan="1" rowSpan="1">OpenidType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；1-微信公众号，2-微信⼩程 序</td></tr><tr><td colSpan="1" rowSpan="1">Ip</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；⽤户IP</td></tr><tr><td colSpan="1" rowSpan="1">PhoneNumber</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；⼿机号（⽤于辅助⻛险判 断，⽽⾮与⼿机运营商实名信息进⾏核验。）</td></tr><tr><td colSpan="1" rowSpan="1">Imei</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；IMEI或IDFV</td></tr><tr><td colSpan="1" rowSpan="1">Type</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">可选值： 仅⽀持居⺠身份证号和⼿机号加密 MD5：⼿机号/身份证号码MD5加密 SHA256：⼿机号/身份证号码SHA256加密 SM3：⼿机号/身份证号码SM3加密 默认不填表示IdNumber为身份证号原⽂</td></tr><tr><td colSpan="1" rowSpan="1">IDType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">证件类型，出⼊境证件查询必须填此参数： 0(或不传): 身份证号 414：定居国外的中国公⺠护照，输⼊中⽂姓名 516：港澳居⺠来往内地通⾏，输⼊中⽂姓名 553：外国⼈永久居留身份证，输⼊英⽂姓名，顺序格式参 照证件上即可</td></tr><tr><td colSpan="1" rowSpan="1">NationCode</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">国际简码，出⼊境证件查询必须填此参数； ⻓度3位，请⻅&quot;国际简码 ISO 3166-1”，定居国外的中国公 ⺠和港澳居⺠使⽤CHN</td></tr></table>3、输出参数 <table ><tr><td colSpan="1" rowSpan="1">参数名称</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">AuthInfo</td><td colSpan="1" rowSpan="1">AuthInfo</td><td colSpan="1" rowSpan="1">⼀致性结果</td></tr><tr><td colSpan="1" rowSpan="1">RiskInfo</td><td colSpan="1" rowSpan="1">RiskInfo</td><td colSpan="1" rowSpan="1">该字段为预留字段，暂时⽆⽤；⻛险识别 注意：此字段可能返回 null，表示取不到有效值。</td></tr><tr><td colSpan="1" rowSpan="1">ValidateData</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">认证序列</td></tr><tr><td colSpan="1" rowSpan="1">RequestId</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">唯⼀请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。</td></tr></table>AuthInfo ⼀次性核检信息 <table ><tr><td colSpan="1" rowSpan="1">名称</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述(是否收费项)</td></tr><tr><td colSpan="1" rowSpan="1">Code</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">核验结果返回码： 00： 认证通过(是) 98： 认证不通过(是) 01： 姓名格式不正确，不能为空 02： 身份证号码有误 04： ⽆此身份证号</td></tr><tr><td colSpan="1" rowSpan="1">Message</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">核验结果描述</td></tr></table>RiskInfo ⻛险识别信息 <table ><tr><td colSpan="1" rowSpan="1">名称</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">DeviceRisk</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">设备⻛险</td></tr><tr><td colSpan="1" rowSpan="1">EnvRisk</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">环境⻛险</td></tr><tr><td colSpan="1" rowSpan="1">AccountRisk</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">账号⻛险</td></tr></table> 4.调用示例<pre><code> curl --location --request POST &#x27;https://<code>tianyu</code>.yunaq.com/api/v1/tianyu/query-idCardAuth&#x27; \ --header &#x27;sign: DiQ9UfF6sOS1fZs0yAqDa60pHZ62FgPA21HAR7Twm96rS0uOmC/C9ctxiJ+1kb57HeZllTBK9bY2sgMOKlKPSkTdZUP7saNz7ojgtQcSAv09ogisC9TxUPQeAfGI92bRAQPH+J/Zk7OF8+PZtk1Pkd7LJlQYt8SgGOEV7bQUbopmqMRoN8KTIxrM37ahxCgTQk39psRCxt5AbM5FeAMd0WauFvy2TGu+CJwzJyU4MT4/7GDvS5Kn4sMr0tw8HigwZ0uSRfyLyvJNJI5sX9ofNof8QbRz5tr58J8hxjyyV/XSccVLRT1ZQR9umaK405D4IduK5Pcp6nJIskDmA==&#x27; \ --header &#x27;Content-Type: application/json&#x27; \ --data-raw &#x27;{ &quot;appid&quot;:&quot;cWkxxxxxxxxxxxxsz&quot;, &quot;nonce_str&quot;:&quot;JQJYCOs7vCTSrrfX8o2Pq&quot;, &quot;content&quot;: &quot;{\&quot;Action\&quot;:\&quot;BspIdCardAuth\&quot;,\&quot;Version\&quot;:\&quot;2020-02-26\&quot;,\&quot;IdNumber\&quot;:\&quot;420901199006176084\&quot;,\&quot;Name\&quot;:\&quot;%E5%BC%A0%E4%B8%89\&quot;}&quot;, &quot;timestamp&quot;:&quot;1599720645284&quot; }&#x27;</code></pre>输出示例<pre><code>{ &quot;Response&quot;: { &quot;RequestId&quot;: &quot;0778c33d-e4d7-4e9b-9038-8a3678a218db&quot;, &quot;ValidateData&quot;: &quot;&quot;, &quot;AuthInfo&quot;: { &quot;Code&quot;: &quot;00&quot;, &quot;Message&quot;: &quot;认证通过&quot; }, &quot;RiskInfo&quot;: { &quot;DeviceRisk&quot;: 0, &quot;EnvRisk&quot;: 0, &quot;AccountRisk&quot;: 0 } } }</code></pre>

1.接口描述接口请求域名： https://sec.yunaq.com 验证姓名、身份证⼀致性结果

身份安全验证接⼝

创宇信用

热门搜索词

热门文章

关注知道创宇云安全

完善信息下载白皮书

热门搜索词

热门文章

关注知道创宇云安全