腾讯云-人脸核身

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；依托于证件OCR识别、活体检测、1：1人脸比对等AI技术，实现自然人真实身份核验的产品。秒级确认用户身份，帮助提升业务办理效率，降低人力成本。

大厂接口

会员资源包统一计费，无需单独购买，开通会员包后可直接调用。

身份证识别及信息核验

接入点说明

本接口用于校验姓名和身份证号的真实性和一致性，您可以通过输入姓名和身份证号或传入身份证人像面照片提供所需验证信息。

接口地址

https://connector.showapi.com/2547-17?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
content-type	String	application/x-www-form-urlencoded	否

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
ImageBase64	String	-	否	身份证人像面的 Base64 值支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经Base64编码后不超过 3M。请使用标准的Base64编码方式(带=补位)，编码规范参考RFC4648。
ImageUrl	String	-	否	身份证人像面的 Url 地址支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。支持的图片大小：所下载图片经 Base64 编码后不超过 3M。图片下载时间不超过 3 秒。图片存储于腾讯云的 Url 可保障更高的下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的 Url 速度和稳定性可能受一定影响。
IdCard	String	-	否	身份证号姓名和身份证号、ImageBase64、ImageUrl三者必须提供其中之一。若都提供了，则按照姓名和身份证号>ImageBase64>ImageUrl的优先级使用参数。
Name	String	-	否	姓名

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/2547-17?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ds_id=&ImageBase64=&ImageUrl=&IdCard=&Name="

返回示例

JSON

{
  "showapi_res_error": "",
  "showapi_res_code": 0,
  "showapi_res_id": "605303338d57baec19040aab",
  "showapi_res_body": {
    "ret_code": 0,
    "remark": "调用成功！",
    "Response": {
       "Result": "0",
       "Description": "姓名和身份证号一致",
       "Name": "**杰",
       "IdCard": "360*************50",
       "Sex": "",
       "Nation": "",
       "Birth": "",
       "Address": "",
       "RequestId": "945c69ad-d86c-47ea-ba33-419b1dc4d242"
    }
  }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

{
  "mcpServers": {
    "showapi-mcp-2547": {
      "url": "http://www.showapi.com.cn/mcp/2547/{your_appKey}"
    }
  }
}

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON