医加云·开放平台

主题

身份证二要素核验 FunctionCode | SER-B006 ​

用户在业务流程中调用此接口，输入身份证号码与姓名。接口迅速将这些信息传输至对接的权威数据源，通常是与公安身份信息数据库相连。数据源依据存储的真实身份数据进行比对，然后接口快速将比对结果，即核验是否通过，返回给调用方，整个过程高效且准确

简介 ​

身份证二要素核验接口，是一种基于数字化技术搭建的数据交互通道，专门用于核实身份证号码与对应的姓名是否匹配。通过该接口，用户能够便捷地将待核验的身份证号码和姓名信息发送至指定的验证系统，获取准确的验证结果反馈。

接口说明 ​

  • 请求方式 POST
  • Headers serviceCode: SER-B006
  • Headers Content-Type: application/json
  • Headers Authorization: Bearer ${app_token}
正式环境 测试环境
https://api.linkingopen.com/service/openapicore/gatewayhttps://api.linkingopen.com/test/service/openapicore/gateway

请求参数 ​

名称 描述 类型 必填
id_card身份证号string是
name姓名string是

返回参数 ​

名称 描述 类型 必填
certification_status验证结果， T:校验⼀致;F:校验不⼀致string是

接口示例 ​

参数示例 ​

以下是JSON：

json
    {
        "id_card": "2205021988xxxxxx",
        "name": "张xx"
    }
json
    {
        "certification_status": "T"
    }

SDK示例 ​

Java
public class SDKExample {
    public static void main(String[] args) {
        // Java示例：初始化SDK并调用一个方法
        SDK sdk = new SDK();
        sdk.initialize();
        sdk.processImage("image.jpg");
    }
}
C#
using System;

public class SDKExample {
    public static void Main() {
        // .NET 示例：初始化SDK并调用方法
        SDK sdk = new SDK();
        sdk.Initialize();
        sdk.ProcessImage("image.jpg");
    }
}
Js
async function runExample() {
    // Node.js 示例：初始化SDK并调用异步方法
    const sdk = new SDK();
    await sdk.initialize();
    await sdk.processImage('image.jpg');
}

常见业务状态码 ​

错误码 描述 解决方案
SYSTEM_ERROR系统繁忙服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER参数有误请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
APP_NOT_ONLINE小程序未处于上架状态小程序上架状态再操作