调用CreateWhitelist将实人认证的终端用户添加到白名单，使该终端用户在白名单有效期内进行实人认证时，默认认证通过。
针对某个终端用户身份真实有效，但却未通过实人认证的场景（例如，由于该用户身份未被权威认证源覆盖、处于风险管控期间等），您可以将该终端用户添加到实人认证白名单。
该接口的QPS上限为10 QPS。
说明 为了保障您的业务安全，请您务必在添加白名单之前，核实用户信息的真实性。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateWhitelist |
要执行的操作。取值：CreateWhitelist。 |
| BizId | String | 是 | aaaeeee160569361xxxx |
您自定义的认证ID。该认证ID表示标识一次认证任务，长度不超过64字符。请确保认证ID是唯一的。 说明 发起不同的认证任务时需要更换不同的BizId。
|
| IdCardNum | String | 是 | 34xxxxxxxxxxxxxxxx |
添加到白名单的终端用户的身份证号码。 |
| ValidDay | String | 是 | 30 |
白名单的有效天数。取值：3、7、30。 |
| BizType | String | 否 | RPBasicTest |
要接入的认证场景的标识。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
本次请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateWhitelist
&BizId=aaaeeee160569361xxxx
&IdCardNum=34xxxxxxxxxxxxxxxx
&ValidDay=30
&<公共请求参数>正常返回示例
XML格式
<CreateWhitelistResponse>
<RequestId>130A2C10-B9EE-4D84-88E3-5384FF039795</RequestId>
</CreateWhitelistResponse>JSON格式
{
"RequestId": "130A2C10-B9EE-4D84-88E3-5384FF039795"
}错误码
访问错误中心查看更多错误码。