腾讯云-人脸核身

连接器

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

大厂接口

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

获取实名核身结果信息

接入点说明

完成验证后，用BizToken调用本接口获取结果信息，BizToken生成后三天内（3*24*3,600秒）可多次拉取。

接口地址

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

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
BizToken	String	CE661F1A-0F1E-45BD-BE13-34C05CEA7681	是	人脸核身流程的标识，调用DetectAuth接口时生成。
RuleId	String	0	是	用于细分客户使用场景，申请开通服务后，可以在腾讯云慧眼人脸核身控制台（https://console.cloud.tencent.com/faceid）自助接入里面创建，审核通过后即可调用。如有疑问，请加慧眼小助手微信（faceid001）进行咨询。
InfoType	String	0	否	指定拉取的结果信息，取值（0：全部；1：文本类；2：身份证正反面；3：视频最佳截图照片；4：视频）。如 134表示拉取文本类、视频最佳截图照片、视频。

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/2547-12?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ds_id=&BizToken=CE661F1A-0F1E-45BD-BE13-34C05CEA7681&RuleId=0&InfoType=0"

返回示例

JSON

{
    "showapi_res_error":"",
    "showapi_res_id":"012a7b26c9094c40b830875139470b1e",
    "showapi_res_code":0,
    "showapi_res_body":{
        "Response":{
    "DetectInfo": "{\"Text\":{\"ErrCode\":null,\"ErrMsg\":null,\"IdCard\":\"\",\"Name\":\"\",\"OcrNation\":null,\"OcrAddress\":null,\"OcrBirth\":null,\"OcrAuthority\":null,\"OcrValidDate\":null,\"OcrName\":null,\"OcrIdCard\":null,\"OcrGender\":null,\"LiveStatus\":null,\"LiveMsg\":null,\"Comparestatus\":null,\"Comparemsg\":null,\"Extra\":\"\",\"Detail\":{\"LivenessData\":[]}},\"IdCardData\":{\"OcrFront\":null,\"OcrBack\":null},\"BestFrame\":{\"BestFrame\":null},\"VideoData\":{\"LivenessVideo\":null}}",
    "RequestId": "0f96cf39-a183-485c-ab29-8427ab81f9ae"
  },
        "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