实名认证
身份证二要素核验：姓名与身份证号是否一致
调用地址：https://api.ynlskj.com.cn/gateway/idcard
复制
请求方法：POST
在其他地方怎么调用
请求地址用上面的调用地址，把 JSON 放在请求体里
方法用 POST
API Key 只能放在请求头 X-API-Key，不要写进网址，也不要写进 Query 框Key 在「个人中心 → API Key」里复制，登录后会自动填入你自己的 Key
参数说明
参数 位置 必填 说明 nameBody JSON 是 真实姓名 idcardBody JSON 是 身份证号（18 位，最后一位可以是 X） X-API-KeyHeader 是 你的 API Key
请求示例
场景 Body 示例 二要素核验 {"name":"张三","idcard":"110101199003078515"}
返回说明
字段 说明 retok 成功，err 失败code上游业务码，200 表示查询完成（是否一致看 data.result） success上游是否调用成功 errmsg上游原始提示，如「成功」 data.result0 一致，1 不一致。极少数情况为库无 data.desc结果说明，如「一致」「不一致」 data.sex性别（由身份证号解析） data.birthday出生日期 data.address户籍地址 msg本站提示，如「次数充足，剩余 99 次」或「次数不足，剩余 0 次」 remain_quota本次调用后的剩余次数
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key，不会展示别人的。
PHP
Python
Go
JavaScript
Java
C#
cURL
复制
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/idcard');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"name": "张三",
"idcard": "110101199003078515"
}',
]);
echo curl_exec($ch);
复制
import requests
url = 'https://api.ynlskj.com.cn/gateway/idcard'
headers = {'X-API-Key': '你的密钥'}
resp = requests.post(url, headers=headers, json={
"name": "张三",
"idcard": "110101199003078515"
}, timeout=15)
print(resp.text)
复制
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"name": "张三",
"idcard": "110101199003078515"
}`)
req, _ := http.NewRequest("POST", "https://api.ynlskj.com.cn/gateway/idcard", body)
req.Header.Set("X-API-Key", "你的密钥")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}
复制
fetch('https://api.ynlskj.com.cn/gateway/idcard', {
method: 'POST',
headers: {
'X-API-Key': '你的密钥',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "张三",
"idcard": "110101199003078515"
})
})
.then(res => res.json())
.then(data => console.log(data));
复制
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ynlskj.com.cn/gateway/idcard"))
.header("X-API-Key", "你的密钥")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\n \"name\": \"张三\",\n \"idcard\": \"110101199003078515\"\n}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
复制
using System.Net.Http;
using System.Text;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "你的密钥");
var content = new StringContent("{\n \"name\": \"张三\",\n \"idcard\": \"110101199003078515\"\n}", Encoding.UTF8, "application/json");
var result = await client.PostAsync("https://api.ynlskj.com.cn/gateway/idcard", content);
Console.WriteLine(await result.Content.ReadAsStringAsync());
复制
curl -X POST "https://api.ynlskj.com.cn/gateway/idcard" \
-H "X-API-Key: 你的密钥" \
-H "Content-Type: application/json" \
-d '{
"name": "张三",
"idcard": "110101199003078515"
}'
请求参数演示
{
"name": "张三",
"idcard": "110101199003078515"
}
响应演示
{
"code": 200,
"success": true,
"errmsg": "成功",
"data": {
"result": 0,
"desc": "一致",
"sex": "男",
"birthday": "19900307",
"address": "北京市东城区",
"orderNo": "demo"
},
"msg": "次数充足，剩余 99 次",
"remain_quota": 99
}