腾讯云-人脸核身

连接器

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

大厂接口

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

实名核身鉴权

接入点说明

每次调用人脸核身SaaS化服务前，需先调用本接口获取BizToken，用来串联核身流程，在验证完成后，用于获取验证结果信息。

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
RuleId	String	0	是	用于细分客户使用场景，申请开通服务后，可以在腾讯云慧眼人脸核身控制台（https://console.cloud.tencent.com/faceid）自助接入里面创建，审核通过后即可调用。如有疑问，请加慧眼小助手微信（faceid001）进行咨询。
IdCard	String	-	否	身份标识（与公安权威库比对时必须是身份证号）。规则：a-zA-Z0-9组合。最长长度32位。
Name	String	-	否	姓名。最长长度32位。中文请使用UTF-8编码。
RedirectUrl	String	-	否	认证结束后重定向的回调链接地址。最长长度1024位。
Extra	String	-	否	透传字段，在获取验证结果时返回。
ImageBase64	String	-	否	用于人脸比对的照片，图片的BASE64值； BASE64编码后的图片数据大小不超过3M，仅支持jpg、png格式。

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

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

返回示例

JSON

{
    "showapi_res_error":"",
    "showapi_res_id":"012a7b26c9094c40b830875139470b1e",
    "showapi_res_code":0,
    "showapi_res_body":{
        "Response":{
    "BizToken": "CE661F1A-0F1E-45BD-BE13-34C05CEA7681",
    "Url": "https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx2cca36a86d5035ae&redirect_uri=http%3A%2F%2Fopen.faceid.qq.com%2Fv1%2Fapi%2FgetCode%3FbizRedirect%3Dhttp%253A%252F%252Ffaceid.qq.com%252Fapi%252Fauth%252FgetOpenidAndSaveToken%253Ftoken%253DCE661F1A-0F1E-45BD-BE13-34C05CEA7681&response_type=code&scope=snsapi_base&state=&component_appid=wx9802ee81e68d6dee#wechat_redirect",
    "RequestId": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a"
  },
        "remark":"调用成功！",
        "ret_code":0
    }
}

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