接口简介:
查询支付宝人脸认证【1】接口发起的用户人脸认证结果,建议轮询查询,查询间隔建议1秒以上。
请求地址:
https://cn.apihz.cn/api/shiming/alipayzfbrl3.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【查询ID】【cxid】【是】【查询ID通过调用支付宝人脸认证【1】获得,例:cxid=d619fdb11c6e8f20e760629fc54ba6f4】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200认证成功,400错误,402用户还未扫脸或扫脸认证失败】
【消息内容】【msg】【msg返回息提示。】
【认证姓名】【name】【认证姓名。】
【身份证】【number】【身份证号码。】
【认证发起时间】【addtime】【认证发起时间。】
【认证结束时间】【endtime】【认证结束时间,结束时间为调用该接口查询认证成功时的触发时间。】
GET请求示例:
https://cn.apihz.cn/api/shiming/alipayzfbrl3.php?id=88888888&key=88888888&cxid=d619fdb11c6e8f20e760629fc54ba6f4
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"code":402,"msg":"还未认证或认证失败。"}
示例:
{
"code": 200,
"name": "张三",
"number": "510704202010153628",
"msg": "认证成功",
"addtime": "2025-10-16 03:09:41",
"endtime": "2025-10-16 03:14:17"
}
参考资料(版权):
https://www.apihz.cn/api/shimingalipayzfbrl3.html