1. 接口描述
接口请求域名: afc.tencentcloudapi.com 。
天御反欺诈服务,主要应用于银行、证券、保险、P2P等金融行业客户,通过腾讯的大数据风控能力,
可以准确识别恶意用户信息,解决客户在支付、活动、理财,风控等业务环节遇到的欺诈威胁,降低企业
的损失。
默认接口请求频率限制:10000次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:QueryAntiFraudVip。 |
Version | 是 | String | 公共参数,本接口取值:2020-02-26。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
PhoneNumber | 否 | String | 电话号码(五选二) |
IdNumber | 否 | String | Id号(五选二) |
BankCardNumber | 否 | String | 银行卡号(五选二) |
UserIp | 否 | String | 用户请求来源 IP(五选二) |
Imei | 否 | String | 国际移动设备识别码,和Idfa同时传入时,只看作一个关键入参(五选二) |
Idfa | 否 | String | ios 系统广告标示符,和Imei同时传入时,只看作一个关键入参(五选二) |
Scene | 否 | String | 业务场景 ID,需要找技术对接 |
Name | 否 | String | 姓名 |
EmailAddress | 否 | String | 用户邮箱地址 |
Address | 否 | String | 用户住址 |
AccountType | 否 | String | 关联的腾讯帐号 QQ:1; 开放帐号微信: 2; |
Uid | 否 | String | 可选的 QQ 或微信 openid |
AppIdU | 否 | String | qq 或微信分配给网站或应用的 appid,用来 唯一标识网站或应用 |
WifiMac | 否 | String | WIFI MAC |
WifiSSID | 否 | String | WIFI 服务集标识 |
WifiBSSID | 否 | String | WIFI-BSSID |
BusinessId | 否 | String | 业务 ID,在多个业务中使用此服务,通过此 ID 区分统计数据 |
IdCryptoType | 否 | String | Id加密类型 0:不加密(默认值) 1:md5 2:sha256 3:SM3 |
PhoneCryptoType | 否 | String | 手机号加密类型 0:不加密(默认值) 1:md5, 2:sha256 3:SM3 |
Mac | 否 | String | MAC 地址 |
Imsi | 否 | String | 国际移动用户识别码 |
NameCryptoType | 否 | String | 姓名加密类型0:不加密(默认值)1:md5 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Found | Integer | 表示该条记录能否查到:1为能查到,-1为查不到 |
IdFound | Integer | 表示该条Id能否查到:1为能查到,-1为查不到 |
RiskScore | Integer | 0~100;值越高 欺诈可能性越大(注:该字段真实类型为有符号整型) |
RiskInfo | Array of RiskDetail | 扩展字段,对风险类型的说明 注意:此字段可能返回 null,表示取不到有效值。 |
CodeDesc | String | 业务侧错误码。成功时返回Success,错误时返回具体业务错误原因。 注意:此字段可能返回 null,表示取不到有效值。 |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 定制接模接口示例
输入示例
https://afc.tencentcloudapi.com/?Action=QueryAntiFraudVip
&AccountType=1%0D%0A
&AppIdU=100273020%0D%0A
&BankCardNumber=12345678%0D%0A
&BusinessId=0%0D%0A
&EmailAddress=373909726%2540qq.com%0D%0A
&IdNumber=1234567890%0D%0A
&Imei=54654654646%0D%0A
&Imsi=xxxyyzz%0D%0A
&Name=%25E6%259D%25A8%25E7%25BA%25A2%0D%0A
&PhoneNumber=008613246208548%0D%0A
&Uid=00000000000000000000000033121475%0D%0A
&Mac=00-01-6C-06-A6-29%0D%0A
&WifiSSID=test%02wifi%0D%0A
&WifiBSSID=00-04-C3-A1-2B-22
&<公共请求参数>
输出示例
{
"Response": {
"CodeDesc": "Success",
"Found": 1,
"IdFound": -1,
"RequestId": "23297af7-a805-4d9d-a9cb-825de5f8ed8c",
"RiskInfo": [],
"RiskScore": 800
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure.CapSigError | 验证码签名错误。 |
AuthFailure.Expired | 请求过期。 |
InternalError | 内部错误。 |
InternalError.BackendLogicError | 业务系统逻辑错误。 |
InternalError.SignBackendError | Sign后端错误。 |
InvalidParameter.ParamError | 参数错误。 |
InvalidParameter.UrlError | URL错误。 |
InvalidParameter.VersionError | 版本错误。 |
InvalidParameterValue.BadBody | BadBody。 |
InvalidParameterValue.BodyTooLarge | 请求包过大。 |
InvalidParameterValue.CapMisMatch | 验证码不匹配。 |
InvalidParameterValue.HttpMethodError | HTTP方法错误。 |
LimitExceeded.FreqCnt | 超过配额。 |
LimitExceeded.IpFreqCnt | 超过配额。 |
LimitExceeded.KeyFreqCnt | 关键词频控限制。 |
LimitExceeded.ReplayAttack | 重放攻击。 |
ResourceNotFound.InterfaceNotFound | 接口不存在。 |
ResourceUnavailable.PermissionDenied | 未开通服务权限。 |
UnauthorizedOperation.AuthFailed | 鉴权失败。 |
UnknownParameter.SecretIdNotExists | 密钥不存在。 |