4.6 - 灵活用工人脸识别认证

POST

person.face.verify

接口描述：
商户调用本接口为已签约（SIGN_STAT=1）的灵活用工人员发起人脸识别认证，平台基于实名信息（姓名、身份证号）及人脸识别结果（活体检测与人证比对）进行校验，认证通过后更新人脸认证状态。

业务规则：
仅限已签约人员调用，人脸认证有效期为6个月，商户可以在人脸识别认证快过期的时候进行调用，重新更新有效期，认证结果可通过 4.5 - 灵活用工人员状态信息查询接口查询。

请求参数

Body 参数application/json必填

示例

{
  "name": "张三",
  "idNo": "110101199001011234",
  "notifyUrl": "https://api.xxx.com/face/auth/notify",
  "redirectUrl": "https://h5.xxx.com/face/result"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://lylw.faqianbei.comperson.face.verify' \
--header 'Content-Type: application/json' \
--data '{
  "name": "张三",
  "idNo": "110101199001011234",
  "notifyUrl": "https://api.xxx.com/face/auth/notify",
  "redirectUrl": "https://h5.xxx.com/face/result"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": "0000",
  "msg": "请求成功",
  "applyNo": "FACE202603261234567890",
  "faceUrl": "https://face.xxx.com/auth?token=abc123xyz&certNo=FACE202603261234567890"
}

修改于 2026-05-06 09:47:46

4.5 - 灵活用工人员状态信息查询

4.6.1 - 人脸识别认证回调