手机号三要素核验详版-实人认证(ID Verification)-阿里云帮助中心

本文介绍手机号三要素详版API接口。手机号三要素指手机号、姓名和证件号。接口会用手机号对比其与姓名和证件号的一致性。

接口信息

重要

在使用本接口前，请确保已完整阅读接入流程，并开通服务。

服务地址（调用 API 时的 Endpoint）：

地域	IPv4	IPv6
通用	cloudauth.aliyuncs.com	cloudauth-dualstack.aliyuncs.com
北京	cloudauth.cn-beijing.aliyuncs.com	cloudauth-dualstack.cn-beijing.aliyuncs.com
上海	cloudauth.cn-shanghai.aliyuncs.com	cloudauth-dualstack.cn-shanghai.aliyuncs.com

说明

重要

信息核验服务暂不支持基于调用次数的硬性封顶或自动停用功能。为有效控制成本并防范高额账单风险，建议在接入产品后及时配置消费告警规则：

名称	类型	是否必选	描述	示例值
ParamType	String	是	加密方式： normal：明文不加密 md5：MD5加密重要所有参数的密文均取32位小写MD5字符串形式。不同MD5工具得出的密文可能不同，如果加密前接口可以调通但加密后不行，请尝试更换MD5工具。 sm2：SM2加密重要 SM2参数加密的相关信息，请参考参数加密说明。	normal
IdentifyNum	String	是	身份证号：说明仅支持二代居民身份证和港澳台居住证的证件号码。 paramType 传 normal 时：传入身份证号明文。 paramType 传 md5 时：传入身份证号密文。	明文：429001********8211 密文： 32fa7bcd874161bea8ec8fd98f390ec9
UserName	String	是	姓名： paramType 传 normal 时：传入姓名明文。 paramType 传 md5 时：传入姓名密文。	明文：张三密文： 32fa7bcd874161bea8ec8fd98f390ec9
Mobile	String	是	手机号： paramType 传 normal 时：传入手机号明文。 paramType 传 md5 时：传入手机号密文。	明文：186****2055 密文： 849169cd3b20621c1c78bd61a11a4fc2

名称		类型	描述	示例值
RequestId		String	请求ID。	130A2C10-B9EE-4D84-88E3-5384FF039795
Message		String	返回信息。	success
Code		String	返回码。 200为成功，其他为失败。重要此参数代表是否正确调用了接口，详细的返回码说明请参见服务端错误码。业务核验结果请通过ResultObject中的字段查看。	200
ResultObject	BizCode	String	核验结果： 1：校验⼀致 2：校验不⼀致 3：查⽆记录	2
	SubCode	String	核验详细结果： 101：验证通过，三要素校验一致。 201：手机号与姓名、证件号对比均不一致。 202：手机号与姓名一致，但与证件号不一致。 203：手机号与姓名不一致，但与证件号一致。 204：其他不一致。 301：查无记录。	201
	IspName	String	运营商名称： CMCC：移动 CUCC：联通 CTCC：电信 CBCC：广电	CMCC

重要

集成前请确保您已完整阅读接入流程，开通了服务并获取AccessKey且正确配置环境变量。

关于SDK示例和安装包获取：

您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例，并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
说明
注意选择所需的编程语言。
如果您有离线安装的需求，可以进入SDK安装页面选择需要语言的SDK，并转到发布地址获取。