意愿核验APP接入指南
更新时间：2026-11-05
1、意愿核身APP接入指南
1.1 增加音频权限
| 名称 | 用途 |
|---|---|
| Privacy - Microphone Usage Description | 意愿核身需要打开麦克风权限，用于音频采集 |
1.2 增加采集意愿核身采集SDK参数
[BDFaceBaseKitManager sharedInstance].paramsCustomConfigItem.isOpenWillCheck = YES;1.3 获取verify_token+上传意愿核验文本信息：意愿核身流程开始，初始化获取唯一的流程verify_token，同时上传意愿核验需要的朗读问题/答案列表文本
请求说明
注意事项：
- 请求体格式化：Content-Type为
application/json，通过json格式化请求体。
请求示例
HTTP方法：POST
请求URL： https://aip.baidubce.com/rpc/2.0/brain/solution/faceprint/verifyToken/generate
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
Body中放置请求参数，参数详情如下：
请求参数：
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| match_source | 是 | int | 方案类型（比对源）；0：实名认证（权威库）；1：人脸比对（上传照片）；2：仅活体检测。 |
| plan_id | 是 | string | 请在 控制台->人脸实名认证->项目管理->方案管理 查看创建的APP方案id，APP方案id关联了图片质量检测（云端）、活体检测（云端）、合成图检测（云端），对比阈值（云端） |
| will_verify | 是 | NSDictionary | 意愿核验问答模式字段 |
｜└ verify_text｜是｜string｜问题文本｜ ｜└ verify_answer｜是｜string｜答案文本｜
-
请求示例
{ "match_source": 0, //以权威库核验场景为例，需要传入0 "plan_id": 16144, "will_verify": { "verify_text": "请确认本次业务是您本人自愿办理吗? 请回答“是的，我确认", "verify_answer": "是的，我确认" }
1.4 调用SDK进行意愿核验：意愿核验流程开始，调用SDK进行意愿核验
| 返回值 | API | 描述 |
|---|---|---|
| void | startCheckWillVerificationAction:(NSDictionary *)dic | |
| callBack:(void(^)(int resultCode, NSDictionary *resultDic))callBack | 意愿核身核验接口 |
入参dic值列表如下：
| 参数 | 类型 | 说明 | 必选 |
|---|---|---|---|
| verify_token | String | key值为verify_token，value需要传入verify_token对应的具体值。需要APP服务端通过AK、SK获取access_token，参考 https://ai.baidu.com/docs#/Auth/top,然后通过access_token获取verify_token 【此处需要注意】verify_token有效期两个小时，建议每次调用接口重新获取verify_token | 是 |
| match_source | int | 方案类型（比对源）；0：实名认证（权威库）；1：人脸比对（上传照片）；**. | 是 |
onCallback回调说明
| 参数 | 类型 | 含义 | 值 |
|---|---|---|---|
| resultCode | int | 错误码 | 0为成功，其他为失败，详情参考实名认证resultCode错误码说明 |
| resultDic | NSDictionary | 回调结果 | 详情见下表 |
-
resultDic返回失败示例
{ code = 283608; "log_id" = 2117151036262080919; message = "\U672a\U83b7\U53d6\U5230\U8bed\U97f3\U8bc6\U522b\U7ed3\U679c"; "remain_error_count" = 3; //意愿核验失败可重试次数 result = "<null>"; success = 0; }
resultDic成功示例
{
"log_id" = 2117152637827723019;
"remain_error_count" = 1;
result = "<null>";
success = 1;
}