拒绝黑产：一文详解如何接入天远数据贷前风险报告多维反欺诈接口

天远API
4 阅读6分钟

构建多维金融防御网：从“经验风控”到“司法级”数据决策

在信贷审批的深水区，传统的征信数据往往难以覆盖隐蔽的司法风险和多头借贷行为。当面对一个看似完美的借款人申请时，如何快速识别其背后的“司法炸弹”或“欺诈团伙”关联？

天远API 的贷前风险报告（专业版）接口正是为解决这一痛点而生。该接口不仅仅是数据的搬运工，更是一个聚合了司法权威数据库、运营商行为分析以及反欺诈评分的决策引擎。通过深度融合多维数据，它能帮助金融机构和开发者迅速构建起一道“信贷安全盾牌”，实现风险管控从粗放的经验判断向精准的数字化等级判断跃迁。

核心接口集成实战

本接口（代码 COMBTY16）采用组合包模式，一次请求即可获取包括反欺诈评分、司法风险、多头借贷、资产状况等多维度的子产品数据。

接口概览

  • 接口地址: https://api.tianyuanapi.com/api/v1/COMBTY16
  • 请求方式: POST
  • 数据安全: 请求体需进行 Base64 编码及加密处理

Python 对接指南 (Production Ready)

以下代码展示了如何封装一个健壮的调用函数，包含了必要的超时控制和异常处理机制。

Python

import requests
import json
import base64
import time

# 模拟加密函数，实际开发请参考天远API官方提供的加解密文档
def _encrypt_data(payload_str):
    """
    占位符：此处应实现AES或其他指定的加密逻辑
    将JSON字符串加密后再进行Base64编码
    """
    # 假设此处已经完成了加密过程
    return base64.b64encode(payload_str.encode('utf-8')).decode('utf-8')

def fetch_risk_report(user_info):
    """
    调用天远贷前风险报告接口
    """
    api_url = f"<https://api.tianyuanapi.com/api/v1/COMBTY16?t=>{int(time.time() * 1000)}"
    
    # 构造原始请求参数 
    raw_payload = {
        "name": user_info.get("name"),
        "mobile_no": user_info.get("mobile_no"),
        "id_card": user_info.get("id_card"),
        "authorization_url": user_info.get("auth_url"), # 必须提供授权书URL
        "authorized": "1", # 1-已授权
        # 可选参数
        "user_type": user_info.get("user_type", "2"), # 默认车辆所有人
        "vehicle_type": "2" # 全部类型
    }

    try:
        # 1. 序列化并加密数据
        payload_json = json.dumps(raw_payload)
        encrypted_data = _encrypt_data(payload_json)
        
        # 2. 构造最终请求体，字段名为 data
        body = {
            "data": encrypted_data
        }

        # 3. 发起请求
        response = requests.post(
            api_url, 
            json=body, 
            headers={'Content-Type': 'application/json'},
            timeout=15  # 建议设置合理的超时时间
        )
        response.raise_for_status()

        # 4. 解析结果
        result = response.json()
        
        # 简单校验组合包响应结构 
        if "responses" in result:
            return result
        else:
            print(f"API调用格式异常: {result}")
            return None

    except requests.exceptions.Timeout:
        print("请求天远API超时，请检查网络或重试")
    except requests.exceptions.RequestException as e:
        print(f"网络请求错误: {e}")
    except Exception as e:
        print(f"系统内部错误: {e}")
        
    return None

# 调用示例
if __name__ == "__main__":
    user_data = {
        "name": "张三",
        "mobile_no": "13800138000",
        "id_card": "110101199003071234",
        "auth_url": "<https://example.com/auth.pdf>"
    }
    report = fetch_risk_report(user_data)
    print(json.dumps(report, ensure_ascii=False, indent=2))

cURL 快速测试

Bash

curl -X POST "<https://api.tianyuanapi.com/api/v1/COMBTY16?t=1716345600000>" \
     -H "Content-Type: application/json" \
     -d '{
           "data": "这里替换为经过加密和Base64编码后的字符串"
         }'

深度解析：组合包数据的“拆包”策略

天远API 的返回结构采用“组合包”模式，开发者需要遍历 responses 数组，根据 api_code 提取对应的子产品数据。以下是核心子产品的字段解析与业务含义。

1. 全局风控评分 (子产品代码: DWBG8B4D)

这是风险决策的核心依据，包含反欺诈评分和信用评分。

核心字段类型描述开发者注意 (Dev Note)
fraudScoreint反欺诈评分 (0-100)高风险区间(80,100] 。分数越高风险越高，建议>80直接拒绝或人工复审。
creditScoreint信用评分 (300-1000)正向指标。分数越高信用越好。(800, 1000] 为优质客户。
checkSuggestString审核建议直接返回业务建议，如“建议拒绝”。
riskWarningObject规则风险提示包含具体的风险点命中详情，如isKeyPerson (重点人员)、hitCriminalRisk (刑事风险)。

2. 司法涉诉透视 (子产品代码: FLXG7E8F)

深入挖掘借款人的法律诉讼记录，区分案件角色（原告/被告）及执行状态。

核心字段类型描述开发者注意 (Dev Note)
consumptionRestrictionListArray限制消费记录也就是俗称的“老赖”名单，核心的一票否决项。
breachCaseListArray失信被执行人列表若数组非空，说明借款人有未履行生效法律文书的行为。
lawsuitStat.count.count_beigaoNumber被告总数重点关注作为被告且未结案的数量，这直接影响还款能力。

3. 多头借贷与资金饥渴度 (子产品代码: JRZQ7F1A)

通过“全景雷达”分析借款人在其他机构的借贷行为。

核心字段类型描述开发者注意 (Dev Note)
A22160006String机构总查询次数申请次数过多（如近1个月查询>10次）通常意味着资金极度短缺。
B22170025String近6个月M0+逾期笔数显性的逾期指标，直接反映近期的还款意愿或能力。
C22180001String网贷授信额度辅助判断其当前的负债承载力。

场景化应用：挖掘数据背后的业务价值

接入 天远API 不仅仅是为了获取一份JSON数据，而是为了构建智能化的业务流程。

场景一：自动化审批流 (Auto-Approval Workflow)

利用 DWBG8B4D 中的评分体系，可以建立自动化的漏斗模型：

  1. 红线过滤: 检查 standLiveInfo.finalAuthResult 是否为 "0" (一致)，且 riskWarning.isKeyPerson (重点人员) 为 0。

  2. 分层处理:

    • fraudScore < 60 且 creditScore > 600：自动通过，进入放款流程。
    • fraudScore > 80 或命中 multCourtInfo.executionCases (执行案件)：自动拒绝。
    • 中间分段：进入人工复审队列。

场景二：存量客户预警 (Portfolio Monitoring)

对于已放款客户，定期调用该接口进行“复诊”。重点关注 overdueRiskProduct (逾期风险产品) 字段。

  • 如果 hasUnsettledOverdue 变为 "逾期" 或 currentOverdueInstitutionCount (当前逾期机构数) 激增，应立即启动贷后催收或资产保全措施。

场景三：额度动态定价 (Dynamic Pricing)

结合 JRZQ8B3C (个人消费能力等级) 和 QCXG9P1C (名下车辆详版)。

  • 若 personincome_index_2.0 评分 > 800 (对应月收入15000+) 且名下持有高价值车辆，可适当提高授信额度或降低利率，以留住优质客户。

结语

在风控领域，数据的广度和深度决定了防御网的坚固程度。天远贷前风险报告（专业版）接口通过单一入口提供了覆盖司法、征信、反欺诈等多维度的权威数据，极大降低了开发者的集成成本。

建议开发者在集成时，务必做好 responses 数组的容错处理，并针对 fraudScore 等关键指标建立符合自身业务偏好的阈值模型，从而真正发挥大数据的风控价值。

avatar
文章
阅读
粉丝