<h2>1.接口描述</h2>接口请求域名： <code>https://tianyu.yunaq.com</code> 金融反欺诈分查询服务，主要应用于银行、证券、保险、P2P等金融行业客户，知道创宇结合腾讯的大数据风控能力， 可以准确识别恶意用户信息，解决客户在支付、活动、理财，风控等业务环节遇到的欺诈威胁，降低企业的损失。接口地址：/api/v1/tianyu/query-anti-fraud <h2>2.输入参数</h2>以下所有参数在入参时，请正确传参，不能传入空值。五选二字段为基本字段，要求至少选择两项。其余参数请查看<a href="https://www.yunaq.com/help/article?id=5f59d440a83eed0011d4c0a6">公共参数</a>部分。<table ><tr><td colSpan="1" rowSpan="1">参数名称</td><td colSpan="1" rowSpan="1">必选</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">PhoneNumber</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">电话号码(五选二)</td></tr><tr><td colSpan="1" rowSpan="1">IdNumber</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">身份证号(五选二)，如0086-15912345687，注意国家代码0086前不需要+号</td></tr><tr><td colSpan="1" rowSpan="1">BankCardNumber</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">银行卡号(五选二)</td></tr><tr><td colSpan="1" rowSpan="1">UserIp</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">用户请求来源 IP(五选二)</td></tr><tr><td colSpan="1" rowSpan="1">Imei</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">国际移动设备识别码(五选二)</td></tr><tr><td colSpan="1" rowSpan="1">Idfa</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">ios 系统广告标示符(五选二)</td></tr><tr><td colSpan="1" rowSpan="1">Scene</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">业务场景 ID，需要找技术对接</td></tr><tr><td colSpan="1" rowSpan="1">Name</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">姓名</td></tr><tr><td colSpan="1" rowSpan="1">EmailAddress</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">用户邮箱地址</td></tr><tr><td colSpan="1" rowSpan="1">Address</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">用户住址</td></tr><tr><td colSpan="1" rowSpan="1">Mac</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">MAC 地址</td></tr><tr><td colSpan="1" rowSpan="1">Imsi</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">国际移动用户识别码</td></tr><tr><td colSpan="1" rowSpan="1">AccountType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">关联的腾讯帐号 QQ：1； 开放帐号微信： 2；</td></tr><tr><td colSpan="1" rowSpan="1">Uid</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">可选的 QQ 或微信 openid</td></tr><tr><td colSpan="1" rowSpan="1">AppIdU</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">qq 或微信分配给网站或应用的 appid，用来 唯一标识网站或应用</td></tr><tr><td colSpan="1" rowSpan="1">WifiMac</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">WIFI MAC</td></tr><tr><td colSpan="1" rowSpan="1">WifiSSID</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">WIFI 服务集标识</td></tr><tr><td colSpan="1" rowSpan="1">WifiBSSID</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">WIFI-BSSID</td></tr><tr><td colSpan="1" rowSpan="1">BusinessId</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">业务 ID，在多个业务中使用此服务，通过此 ID 区分统计数据</td></tr><tr><td colSpan="1" rowSpan="1">IdCryptoType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">Id加密类型 0：不加密（默认值） 1：md5 2：sha256 3：SM3</td></tr><tr><td colSpan="1" rowSpan="1">PhoneCryptoType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">手机号加密类型 0：不加密（默认值） 1：md5, 2：sha256 3：SM3</td></tr><tr><td colSpan="1" rowSpan="1">NameCryptoType</td><td colSpan="1" rowSpan="1">否</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">姓名加密类型 0：不加密（默认值） 1：md5 2：sha256 3：SM3</td></tr></table><h2>3.输出参数</h2><table ><tr><td colSpan="1" rowSpan="1">参数名称</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">Found</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">表示该条记录能否查到：1为能查到，-1为查不到</td></tr><tr><td colSpan="1" rowSpan="1">IdFound</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">表示该条Id能否查到：1为能查到，-1为查不到</td></tr><tr><td colSpan="1" rowSpan="1">RiskScore</td><td colSpan="1" rowSpan="1">Integer</td><td colSpan="1" rowSpan="1">0~100;值越高 欺诈可能性越大</td></tr><tr><td colSpan="1" rowSpan="1">RiskInfo</td><td colSpan="1" rowSpan="1">Array of RiskDetail</td><td colSpan="1" rowSpan="1">扩展字段，对风险类型的说明</td></tr><tr><td colSpan="1" rowSpan="1">CodeDesc</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">业务侧错误码。成功时返回Success，错误时返回具体业务错误原因。 注意：此字段可能返回 null，表示取不到有效值。</td></tr><tr><td colSpan="1" rowSpan="1">RequestId</td><td colSpan="1" rowSpan="1">String</td><td colSpan="1" rowSpan="1">唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。</td></tr></table>RiskDetail扩展字段，对风险类型的说明<table ><tr><td colSpan="1" rowSpan="1">名称</td><td colSpan="1" rowSpan="1">类型</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">RiskCode</td><td colSpan="1" rowSpan="1">Interger</td><td colSpan="1" rowSpan="1">风险码</td></tr></table>风险类型说明<table ><colgroup><col width="113"></col><col width="56"></col><col width="479"></col></<colgroup><tr><td style="text-align:left;" colSpan="1" rowSpan="1">风险详情</td><td style="text-align:left;" colSpan="1" rowSpan="1">2.0风险码</td><td colSpan="1" rowSpan="1">内容</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 资金紧张人群</td><td style="text-align:left;" colSpan="1" rowSpan="1">2101</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似资金紧张人群，有多方借贷，以贷养贷等行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 线上支付白户</td><td style="text-align:left;" colSpan="1" rowSpan="1">3102</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似没有线上支付行为的互联网用户（支付白户），可能是老年人或者互联网新手</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 线上养号小号</td><td style="text-align:left;" colSpan="1" rowSpan="1">3103</td><td style="text-align:left;" colSpan="1" rowSpan="1">在支付金额、频度、场景有非正常操作，号码活跃度与正常用户有差异，疑似线上养号，小号等行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 账号被盗风险</td><td style="text-align:left;" colSpan="1" rowSpan="1">3202</td><td style="text-align:left;" colSpan="1" rowSpan="1">通过腾讯联防联控机制，账号疑似被盗，被撞库，被社交工程破解，账号密码疑似已经泄露</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 资料伪造包装</td><td style="text-align:left;" colSpan="1" rowSpan="1">1101</td><td style="text-align:left;" colSpan="1" rowSpan="1">涉嫌从事包装客户资料，伪造客户资料，冒用客户资料，套取银行信贷机构风险政策的从业人员</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 涉黄涉恐行为</td><td style="text-align:left;" colSpan="1" rowSpan="1">1102</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似参与线上涉黄、涉毒、暴恐等恶意互联网行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 资料仿冒行为</td><td style="text-align:left;" colSpan="1" rowSpan="1">1103</td><td style="text-align:left;" colSpan="1" rowSpan="1">曾经有过虚假身份信息提交，或者个人信息疑似泄露、，冒用、伪造</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 营销活动欺诈</td><td style="text-align:left;" colSpan="1" rowSpan="1">1104</td><td style="text-align:left;" colSpan="1" rowSpan="1">在电商、网贷、O2O平台运营中，疑似有团伙性的薅羊毛，套利等行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 身份信息不符</td><td style="text-align:left;" colSpan="1" rowSpan="1">1105</td><td style="text-align:left;" colSpan="1" rowSpan="1">当前提交信息和腾讯历史提交的身份信息不符，疑似有身份欺诈的风险</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 公开信息失信</td><td style="text-align:left;" colSpan="1" rowSpan="1">1106</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似有失信行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 金融黑产相关</td><td style="text-align:left;" colSpan="1" rowSpan="1">1107</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似金融黑产，有金融欺诈行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 手机猫池欺诈</td><td style="text-align:left;" colSpan="1" rowSpan="1">1108</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似手机号码风险声誉低，存在猫池、接码平台等恶意行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 风险设备环境</td><td style="text-align:left;" colSpan="1" rowSpan="1">1201</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似设备IP风险声誉低，存在虚拟机，代理设备等恶意风险</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 异常支付行为</td><td style="text-align:left;" colSpan="1" rowSpan="1">3101</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似支付行为中包涵高频，小额，大额，伞形集中、伞形分散等风险支付行为</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 线上涉赌行为</td><td style="text-align:left;" colSpan="1" rowSpan="1">3104</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似参与线上赌博活动</td></tr><tr><td style="text-align:left;" colSpan="1" rowSpan="1">疑似 存在失联风险</td><td style="text-align:left;" colSpan="1" rowSpan="1">3201</td><td style="text-align:left;" colSpan="1" rowSpan="1">疑似活跃度不稳定，行为异常，有失联的风险</td></tr></table>Scene（业务场景）说明模型 62，通用模型 scene=1000 模型 63，小额短贷 scene=1002 模型 64，消费分期 scene=1003 模型 60，信用卡模型 scene=1004<h2>4.输出实例</h2><pre class="rno-code-pre"><code>{ &quot;CodeDesc&quot;: &quot;Success&quot;, &quot;Found&quot;: 1, &quot;IdFound&quot;: 1, &quot;PostTime&quot;: &quot;1436664316&quot;, &quot;RiskInfo&quot;: [ { &quot;RiskCode&quot;: 1107 } ], &quot;RiskScore&quot;: 70 }</code></pre><h2>5.错误码</h2><table ><tr><td colSpan="1" rowSpan="1">错误码</td><td colSpan="1" rowSpan="1">描述</td></tr><tr><td colSpan="1" rowSpan="1">AuthFailure.CapSigError</td><td colSpan="1" rowSpan="1">验证码签名错误。</td></tr><tr><td colSpan="1" rowSpan="1">AuthFailure.Expired</td><td colSpan="1" rowSpan="1">请求过期。</td></tr><tr><td colSpan="1" rowSpan="1">InternalError</td><td colSpan="1" rowSpan="1">内部错误。</td></tr><tr><td colSpan="1" rowSpan="1">InternalError.BackendLogicError</td><td colSpan="1" rowSpan="1">业务系统逻辑错误。</td></tr><tr><td colSpan="1" rowSpan="1">InternalError.SignBackendError</td><td colSpan="1" rowSpan="1">Sign后端错误。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameter.ParamError</td><td colSpan="1" rowSpan="1">参数错误。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameter.UrlError</td><td colSpan="1" rowSpan="1">URL错误。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameter.VersionError</td><td colSpan="1" rowSpan="1">版本错误。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameterValue.BadBody</td><td colSpan="1" rowSpan="1">BadBody。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameterValue.BodyTooLarge</td><td colSpan="1" rowSpan="1">请求包过大。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameterValue.CapMisMatch</td><td colSpan="1" rowSpan="1">验证码不匹配。</td></tr><tr><td colSpan="1" rowSpan="1">InvalidParameterValue.HttpMethodError</td><td colSpan="1" rowSpan="1">HTTP方法错误。</td></tr><tr><td colSpan="1" rowSpan="1">LimitExceeded.FreqCnt</td><td colSpan="1" rowSpan="1">超过配额。</td></tr><tr><td colSpan="1" rowSpan="1">LimitExceeded.IpFreqCnt</td><td colSpan="1" rowSpan="1">超过配额。</td></tr><tr><td colSpan="1" rowSpan="1">LimitExceeded.KeyFreqCnt</td><td colSpan="1" rowSpan="1">关键词频控限制。</td></tr><tr><td colSpan="1" rowSpan="1">LimitExceeded.ReplayAttack</td><td colSpan="1" rowSpan="1">重放攻击。</td></tr><tr><td colSpan="1" rowSpan="1">ResourceNotFound.InterfaceNotFound</td><td colSpan="1" rowSpan="1">接口不存在。</td></tr><tr><td colSpan="1" rowSpan="1">ResourceUnavailable.PermissionDenied</td><td colSpan="1" rowSpan="1">未开通服务权限。</td></tr><tr><td colSpan="1" rowSpan="1">UnauthorizedOperation.AuthFailed</td><td colSpan="1" rowSpan="1">鉴权失败。</td></tr></table><h2>6.调用示例</h2><pre><code> curl --location --request POST &#x27;https://tianyu.yunaq.com/api/v1/tianyu/query-anti-fraud&#x27; \ --header &#x27;sign: DiQ9UfF6sOS1fZs0yAqDa60pHZ62FgPA21HAR7Twm96rS0uOmC/C9ctxiJ+1kb57HeZllTBK9bY2sgMOKlKPSkTdZUP7saNz7ojgtQcSAv09ogisC9TxUPQeAfGI92bRAQPH+J/Zk7OF8+PZtk1Pkd7LJlQYt8SgGOEV7bQUbopmqMRoN8KTIxrM37ahxCgTQk39psRCxt5AbM5FeAMd0WauFvy2TGu+CJwzJyU4MT4/7GDvS5Kn4sMr0tw8HigwZ0uSRfyLyvJNJI5sX9ofNof8QbRz5tr58J8hxjyyV/XSccVLRT1ZQR9umaK405D4IduK5Pcp6nJIskDmA==&#x27; \ --header &#x27;Content-Type: application/json&#x27; \ --data-raw &#x27;{ &quot;appid&quot;:&quot;cWkxxxxxxxxxxxxsz&quot;, &quot;nonce_str&quot;:&quot;JQJYCOs7vCTSrrfX8o2Pq&quot;, &quot;content&quot;: &quot;{\&quot;Action\&quot;:\&quot;QueryAntiFraud\&quot;,\&quot;Version\&quot;:\&quot;2020-02-26\&quot;,\&quot;IdNumber\&quot;:\&quot;420901199506176084\&quot;,\&quot;PhoneNumber\&quot;:\&quot;13712345678\&quot;}&quot;, &quot;timestamp&quot;:&quot;1599720645284&quot; }&#x27;</code></pre>补充说明：欺诈分值（risk_score），分值范围0-100，分数越高，风险越高。其中，80-100分高风险用户建议拒绝，60-80分中风险用户建议结合其他业务规则判断，0-60分低风险，建议通过。底层没查到的情况下会默认返回99 分，未查到也被视为高风险，建议拒绝。

知道创宇结合腾讯的大数据风控能力， 可以准确识别恶意用户信息

反欺诈分查询 API 文档

创宇信用

热门搜索词

热门文章

关注知道创宇云安全

完善信息下载白皮书

热门搜索词

热门文章

关注知道创宇云安全