调用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"
}
错误码
访问错误中心查看更多错误码。