适用于金融、保险、在线教育、电商、租赁、物流、旅游等需要实名认证场景。直连自公安部和银联中心接口，实时查询，权威可靠！通过输入姓名和身份证号，即可快速验证姓名与身份证号的真实性和一致性。查看详情
- 接口调用地址：https://api.yonyoucloud.com/apis/dst/matchIdentity/matchIdentity
- 请求方式：post
- 请求参数（header）：
| 参数名 | 必填 | 描述 | 默认值 |
|---|---|---|---|
| Content-Type | true | application/json |
- 请求参数（body）：
| 参数名 | 类型 | 是否数组 | 必填 | 描述 | 默认值 |
| idName | string | 否 | 是 | 身份证号码 | |
| userName | string | 否 | 是 | 身份证姓名 |
- 返回类型参数：
| 参数名 | 类型 | 是否数组 | 必填 | 描述 |
|---|---|---|---|---|
| success | boolean | 否 | 否 | 请求是否成功 |
| code | int | 否 | 否 | 返回码，参照返回码说明 |
| message | string | 否 | 否 | 返回信息 |
- 返回码（code）说明：
| 返回码 | 说明 | 错误信息 |
|---|---|---|
| 400423 | 请求处理时等待超时 | UID Request Timeout |
| 400431 | 身份证信息不匹配 | User identity not match |
| 400420 | 请求参数不合法 | Parameter illegal |
| 400422 | 请求处理时发生异常 | UID Request Exception |
- Java示例
1 import java.io.BufferedReader;
2 import java.io.IOException;
3 import java.io.InputStream;
4 import java.io.InputStreamReader;
5 import java.io.OutputStream;
6 import java.io.UnsupportedEncodingException;
7 import java.net.HttpURLConnection;
8 import java.net.URL;
9 import java.net.URLEncoder;
10 import java.util.HashMap;
11 import java.util.Map;
12
13 import javax.net.ssl.HostnameVerifier;
14 import javax.net.ssl.HttpsURLConnection;
15 import javax.net.ssl.SSLSession;
16
17 import org.json.JSONObject;//可根据需要导入jar
18
19 public class JavaDemo {
20 public static final String DEF_CHATSET = "UTF-8";
21 public static final int DEF_CONN_TIMEOUT = 30000;
22 public static final int DEF_READ_TIMEOUT = 30000;
23 public static String userAgent = "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.66 Safari/537.36";
24
25 public static final HostnameVerifier DO_NOT_VERIFY = new HostnameVerifier() {
26 public boolean verify(String hostname, SSLSession session) {
27 return true;
28 }
29 };
30
31 //配置您申请的KEY
32 public static final String APICODE ="*************************";
33
34 //1.API方法
35 public static void getRequest(){
36 String result =null;
37 String url ="https://api.yonyoucloud.com/apis/dst/matchIdentity/matchIdentity";//请求接口地址
38 String method = "POST";
39 String paramFormat = "form";
40 Map<String, Object> params = new HashMap<String, Object>();//请求参数
41 params.put("idNumber", "");
42 params.put("userName", "");
43
44 Map<String, Object> headerParams = new HashMap<String, Object>();//请求头参数
45 headerParams.put("apicode", APICODE);//APICODE
46 headerParams.put("Content-Type", "application/json");
47
48 try {
49 result = net(url, params, headerParams, method, paramFormat);
50 System.out.println(result);
51 } catch (Exception e) {
52 e.printStackTrace();
53 }
54 }
55
56 /**
57 *
58 * @param strUrl 请求地址
59 * @param params 请求参数
60 * @param method 请求方法
61 * @return 网络请求字符串
62 * @throws Exception
63 */
64 public static String net(String strUrl, Map<String,Object> params, Map<String,Object> headerParams,String method, String paramFormat) throws Exception {
65 HttpURLConnection conn = null;
66 BufferedReader reader = null;
67 String rs = null;
68 try {
69 String contentType = null;
70 if(headerParams.containsKey("Content-Type"))
71 contentType = headerParams.get("Content-Type").toString();
72
73 StringBuffer sb = new StringBuffer();
74 if(method==null || method.equals("GET")){
75 strUrl = strUrl+"?"+urlencode(params);
76 }
77
78 trustAllHttpsCertificates();
79 HttpsURLConnection.setDefaultHostnameVerifier(DO_NOT_VERIFY);
80
81 URL url = new URL(strUrl);
82 conn = (HttpURLConnection) url.openConnection();
83 if(method==null || method.equals("GET")){
84 conn.setRequestMethod("GET");
85 }else{
86 conn.setRequestMethod("POST");
87 conn.setDoOutput(true);
88 }
89 conn.setRequestProperty("User-agent", userAgent);
90 for (String i : headerParams.keySet()) {
91 conn.setRequestProperty(i, headerParams.get(i).toString());
92 }
93 if("form".equals(paramFormat) && !"application/x-www-form-urlencoded".equals(contentType) && !"application/xml".equals(contentType)) {
94 conn.setRequestProperty("Content-Type", "application/json;charset=utf-8");
95 }
96 conn.setUseCaches(false);
97 conn.setConnectTimeout(DEF_CONN_TIMEOUT);
98 conn.setReadTimeout(DEF_READ_TIMEOUT);
99 conn.setInstanceFollowRedirects(false);
100 conn.connect();
101 if (params!= null && method.equals("POST")) {
102 try {
103 OutputStream out = conn.getOutputStream();
104 if("form".equals(paramFormat)) {
105 if("application/x-www-form-urlencoded".equals(contentType))
106 out.write(urlencode(params).getBytes("utf-8"));
107 else if("application/xml".equals(contentType))
108 out.write(xmlencode(params).getBytes("utf-8"));
109 else
110 out.write(jsonencode(params).getBytes("utf-8"));
111 } else
112 out.write(params.toString().getBytes("utf-8"));
113
114 } catch (Exception e) {
115 e.printStackTrace();
116 }
117 }
118 InputStream is = conn.getInputStream();
119 reader = new BufferedReader(new InputStreamReader(is, DEF_CHATSET));
120 String strRead = null;
121 while ((strRead = reader.readLine()) != null) {
122 sb.append(strRead);
123 }
124 rs = sb.toString();
125 } catch (IOException e) {
126 e.printStackTrace();
127 } finally {
128 if (reader != null) {
129 reader.close();
130 }
131 if (conn != null) {
132 conn.disconnect();
133 }
134 }
135 return rs;
136 }
137
138 //将map型转为请求参数型
139 public static String urlencode(Map<String,Object>data) {
140 StringBuilder sb = new StringBuilder();
141 for (Map.Entry i : data.entrySet()) {
142 try {
143 if(("").equals(i.getKey())) {
144 sb.append(URLEncoder.encode(i.getValue()+"","UTF-8"));
145 } else {
146 sb.append(i.getKey()).append("=").append(URLEncoder.encode(i.getValue()+"","UTF-8")).append("&");
147 }
148 } catch (UnsupportedEncodingException e) {
149 e.printStackTrace();
150 }
151 }
152 return sb.toString();
153 }
154
155 //将map型转为请求参数型
156 public static String jsonencode(Map<String,Object>data) {
157 JSONObject jparam = new JSONObject();
158 for (Map.Entry i : data.entrySet())
159 jparam.put(i.getKey(), i.getValue());
160
161 return jparam.toString();
162 }
163
164 //将map型转为请求参数型
165 public static String xmlencode(Map<String,Object>data) {
166 StringBuffer xmlData = new StringBuffer();
167 xmlData.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
168 for (Map.Entry i : data.entrySet())
169 xmlData.append("<" + i.getKey() + ">" + i.getValue() + "</" + i.getKey() + ">");
170
171 return xmlData.toString();
172 }
173
174 static class miTM implements javax.net.ssl.TrustManager, javax.net.ssl.X509TrustManager {
175 public java.security.cert.X509Certificate[] getAcceptedIssuers() {
176 return null;
177 }
178
179 public boolean isServerTrusted(java.security.cert.X509Certificate[] certs) {
180 return true;
181 }
182
183 public boolean isClientTrusted(java.security.cert.X509Certificate[] certs) {
184 return true;
185 }
186
187 public void checkServerTrusted(java.security.cert.X509Certificate[] certs, String authType)
188 throws java.security.cert.CertificateException {
189 return;
190 }
191
192 public void checkClientTrusted(java.security.cert.X509Certificate[] certs, String authType)
193 throws java.security.cert.CertificateException {
194 return;
195 }
196 }
197
198 private static void trustAllHttpsCertificates() throws Exception {
199 javax.net.ssl.TrustManager[] trustAllCerts = new javax.net.ssl.TrustManager[1];
200 javax.net.ssl.TrustManager tm = new miTM();
201 trustAllCerts[0] = tm;
202 javax.net.ssl.SSLContext sc = javax.net.ssl.SSLContext.getInstance("SSL");
203 sc.init(null, trustAllCerts, null);
204 javax.net.ssl.HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
205 }
206
207 public static void main(String[] args) {
208 getRequest();
209 }
210 }
- PHP示例
1 <?php
2 header(‘Content-type:text/html;charset=utf-8‘);
3 //配置您申请的appkey
4 $apicode = "*********************";
5
6 $url = "https://api.yonyoucloud.com/apis/dst/matchIdentity/matchIdentity";
7
8 $method = "POST";
9
10 $params = array(
11 "idNumber" => "",
12 "userName" => "",
13
14 );
15
16 $header = array();
17 $header[] = "apicode:".$apicode;
18 $header[] = "content-type:application/json";
19 $header[] = "Content-Type:application/json";
20
21
22 $content = linkcurl($url,$method,$params,$header);
23 $result = json_decode($content,true);
24 if($result){
25 if($result[‘error_code‘]==‘0‘){
26 print_r($result);
27 }else{
28 echo $result[‘error_code‘].":".$result[‘reason‘];
29 }
30 }else{
31 echo "请求失败";
32 }
33
34 /**
35 * 请求接口返回内容
36 * @param string $url [请求的URL地址]
37 * @param string $params [请求的参数]
38 * @param int $ipost [是否采用POST形式]
39 * @return string
40 */
41 function linkcurl($url,$method,$params=false,$header=false){
42 $httpInfo = array();
43 $ch = curl_init();
44
45 curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
46 curl_setopt($ch, CURLOPT_URL, $url);
47 curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
48 curl_setopt($ch, CURLOPT_FAILONERROR, false);
49 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
50
51 if (1 == strpos("$".$url, "https://"))
52 {
53 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
54 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
55 }
56 curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
57 curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
58 curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
59
60 if($method == "POST" ){
61 curl_setopt( $ch , CURLOPT_POST , true );
62 curl_setopt( $ch , CURLOPT_POSTFIELDS, json_encode($params) );
63 }else if($params){
64 curl_setopt( $ch , CURLOPT_URL , $url.‘?‘.http_build_query($params) );
65 }
66 $response = curl_exec( $ch );
67 if ($response === FALSE) {
68 //echo "cURL Error: " . curl_error($ch);
69 return false;
70 }
71 $httpCode = curl_getinfo( $ch , CURLINFO_HTTP_CODE );
72 $httpInfo = array_merge( $httpInfo , curl_getinfo( $ch ) );
73 curl_close( $ch );
74 return $response;
75 }
76 ?>
- C#示例
1 using System;
2 using System.Collections.Generic;
3 using System.Linq;
4 using System.Text;
5 using System.Net;
6 using System.IO;
7 using System.Diagnostics;
8 using System.Web;
9
10
11 namespace ConsoleAPI
12 {
13 class Program
14 {
15 static void Main(string[] args)
16 {
17 string url ="https://api.yonyoucloud.com/apis/dst/matchIdentity/matchIdentity";//请求接口地址
18 string method = "POST";
19 string apicode = "*******************"; //配置您申请的appkey
20
21 var bodyParams = new Dictionary<string, string>();
22 bodyParams.Add("idNumber", "");
23 bodyParams.Add("userName", "");
24
25 var headerParams = new Dictionary<string, string>();
26 headerParams.Add("apicode", apicode);
27 headerParams.Add("Content-Type", "application/json");
28
29 string result1 = sendPost(url, bodyParams, headerParams, method);
30
31 JsonObject newObj1 = new JsonObject(result1);
32 String errorCode1 = newObj1["error_code"].Value;
33
34 if (errorCode1 == "0")
35 {
36 Debug.WriteLine("成功");
37 Debug.WriteLine(newObj1);
38 }
39 else
40 {
41 //Debug.WriteLine("失败");
42 Debug.WriteLine(newObj1["error_code"].Value+":"+newObj1["reason"].Value);
43 }
44
45
46 }
47
48 /// <summary>
49 /// Http (GET/POST)
50 /// </summary>
51 /// <param name="url">请求URL</param>
52 /// <param name="bodyParams">请求体参数</param>
53 /// <param name="headerParams">请求头参数</param>
54 /// <param name="method">请求方法</param>
55 /// <returns>响应内容</returns>
56 static string sendPost(string url, IDictionary<string, string> bodyParams, IDictionary<string, string> headerParams, string method)
57 {
58 if (method.ToLower() == "post")
59 {
60 HttpWebRequest req = null;
61 HttpWebResponse rsp = null;
62 System.IO.Stream reqStream = null;
63 try
64 {
65 req = (HttpWebRequest)WebRequest.Create(url);
66 req.Method = method;
67 req.KeepAlive = false;
68 req.ProtocolVersion = HttpVersion.Version10;
69 req.Timeout = 5000;
70 req.ContentType = "application/x-www-form-urlencoded;charset=utf-8";
71 BuildHeader(headerParams, req);
72 byte[] postData = Encoding.UTF8.GetBytes(BuildQuery(bodyParams, "utf8"));
73 reqStream = req.GetRequestStream();
74 reqStream.Write(postData, 0, postData.Length);
75 rsp = (HttpWebResponse)req.GetResponse();
76 Encoding encoding = Encoding.GetEncoding(rsp.CharacterSet);
77 return GetResponseAsString(rsp, encoding);
78 }
79 catch (Exception ex)
80 {
81 return ex.Message;
82 }
83 finally
84 {
85 if (reqStream != null) reqStream.Close();
86 if (rsp != null) rsp.Close();
87 }
88 }
89 else
90 {
91 //创建请求
92 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url + "?" + BuildQuery(bodyParams, "utf8"));
93
94 //GET请求
95 request.Method = "GET";
96 request.ReadWriteTimeout = 5000;
97 request.ContentType = "text/html;charset=UTF-8";
98 BuildHeader(headerParams, req);
99 HttpWebResponse response = (HttpWebResponse)request.GetResponse();
100 Stream myResponseStream = response.GetResponseStream();
101 StreamReader myStreamReader = new StreamReader(myResponseStream, Encoding.GetEncoding("utf-8"));
102
103 //返回内容
104 string retString = myStreamReader.ReadToEnd();
105 return retString;
106 }
107 }
108
109 /// <summary>
110 /// 组装普通文本请求参数。
111 /// </summary>
112 /// <param name="parameters">Key-Value形式请求参数字典</param>
113 /// <returns>URL编码后的请求数据</returns>
114 static string BuildQuery(IDictionary<string, string> parameters, string encode)
115 {
116 StringBuilder postData = new StringBuilder();
117 bool hasParam = false;
118 IEnumerator<KeyValuePair<string, string>> dem = parameters.GetEnumerator();
119 while (dem.MoveNext())
120 {
121 string name = dem.Current.Key;
122 string value = dem.Current.Value;
123 // 忽略参数名或参数值为空的参数
124 if (!string.IsNullOrEmpty(name))//&& !string.IsNullOrEmpty(value)
125 {
126 if (hasParam)
127 {
128 postData.Append("&");
129 }
130 postData.Append(name);
131 postData.Append("=");
132 if (encode == "gb2312")
133 {
134 postData.Append(HttpUtility.UrlEncode(value, Encoding.GetEncoding("gb2312")));
135 }
136 else if (encode == "utf8")
137 {
138 postData.Append(HttpUtility.UrlEncode(value, Encoding.UTF8));
139 }
140 else
141 {
142 postData.Append(value);
143 }
144 hasParam = true;
145 }
146 }
147 return postData.ToString();
148 }
149
150 /// <summary>
151 /// 组装请求头参数。
152 /// </summary>
153 /// <param name="headerParams">Key-Value形式请求参数字典</param>
154 /// <param name="req">web请求</param>
155 static void BuildHeader(IDictionary<string, string> headerParams, HttpWebRequest req)
156 {
157 IEnumerator<KeyValuePair<string, string>> dem = headerParams.GetEnumerator();
158 while (dem.MoveNext())
159 {
160 req.Headers.Add(dem.Current.Key, dem.Current.value);
161 }
162 }
163
164 /// <summary>
165 /// 把响应流转换为文本。
166 /// </summary>
167 /// <param name="rsp">响应流对象</param>
168 /// <param name="encoding">编码方式</param>
169 /// <returns>响应文本</returns>
170 static string GetResponseAsString(HttpWebResponse rsp, Encoding encoding)
171 {
172 System.IO.Stream stream = null;
173 StreamReader reader = null;
174 try
175 {
176 // 以字符流的方式读取HTTP响应
177 stream = rsp.GetResponseStream();
178 reader = new StreamReader(stream, encoding);
179 return reader.ReadToEnd();
180 }
181 finally
182 {
183 // 释放资源
184 if (reader != null) reader.Close();
185 if (stream != null) stream.Close();
186 if (rsp != null) rsp.Close();
187 }
188 }
189 }
190 }
- 请求参数示例：
{ "userName":"小明","idNumber":"120902199912135678"}- JSON正确返回示例
{
"success": true,
"code": 400100,
"message": "成功"
}- 错误码说明
调用方错误：
| 错误码 | 说明 | 错误信息 |
|---|---|---|
| 300001 | 请求header中没有设置apikey | Missing apikey |
| 300002 | api不存在或url无法解析 | URL cannot be resolved |
| 300003 | apikey不存在,请输入正确的apikey | apicode does not exist |
| 300004 | 服务剩余次数不足，请再次购买 | Service overdue, please pay in time |
| 300005 | 未设置ip白名单 | not int white ip list |
| 300006 | IP白名单中不包含您的IP | IP white list does not contain your IP |
| 300007 | 系统繁忙稍候再试 | Sorry,The system is busy. Please try again late |
| 300008 | 访问次数超载 | Request was denied due to api flow control |
| 300009 | 未找到节流信息 | not int apiservice paramer |
| 300010 | header参数中缺少需签名的参数值 | request header do not contain param: |
| 300011 | 缺少需验证的参数列表 | no sign headers found! |
| 300012 | 签名信息不匹配 | Signature information mismatch |
| 300013 | header中缺少参数appkey | appkey does not exist in the request header |
| 300014 | header中缺少参数appsecret | appsecret does not exist |
| 300015 | api已过期,请另行购买 | Your API has been expired! |
| 300017 | 要求必填参数为不能为空 | Requied parameter can not be null! |
| 300018 | api没有授权 | The app key do not has the authorization of this api |
- 服务地址：身份证二要素实名认证
- 数据来源：用友旗下中关村银行和第三方支付公司畅捷支付直连银联，通过银联接口实时核验，非缓存数据
特别提醒：选择实名认证接口时一定要仔细甄别，由于身份证实名制服务提供时间已久，很多数据提供商(实则是二
道贩子)利用缓存数据对外提供服务（这些历史缓存数据的源头有可能是NCIIC，这也是他们敢宣称“直连公安部接口”的
原因）。目前国内预计有8亿元的缓存量市场，由于缓存的数据并没有什么成本，所以这些鱼龙混杂的公司，在市面上
提供的接口调用价格甚至低至0.1元/次。实际上不仅其数据更新的及时性远远无法达到NCIIC的标准，而且留存用户信
息的行为本身就是违法的，更不要说用于商业目的。这些服务商随时都面临着被查封的风险，一旦接入这种服务，如
果服务商挂了，给使用接口的单位带来的损失或将是无法估量的。。。
原文地址：https://www.cnblogs.com/loutai/p/10450013.html
时间： 2024-11-05 15:55:09