目录

在电商、金融、支付等业务场景中，每一笔交易都可能存在欺诈风险。通过接入实时风控API，你可以在交易发生的瞬间完成风险决策，自动拦截可疑交易、放行正常订单。本文将手把手教你如何通过3个简单步骤，将风控引擎集成到你的业务系统中，实现毫秒级的交易风险防护。

一、为什么需要实时风控API

传统的事后审核方式已经无法满足现代电商的需求。一个优秀的实时风控API应该具备以下能力：

毫秒级响应

风控决策在50毫秒内完成，不影响用户交易体验。风控系统在后台静默运行，用户无感知。

实时拦截

在交易完成前进行风险决策，高风险交易立即拦截，避免损失已经发生后再处理。

自动化决策

通过规则引擎和评分卡自动判断，仅将灰色地带的交易转人工审核，大幅降低人工成本。

二、第一步：注册并获取API Key

接入风控云的实时风控API非常简单，首先需要获取API密钥：

  1. 访问 app.fengkong.cloud 注册账号（免费版即可开始）
  2. 登录控制台，进入「设置 > API 密钥」页面
  3. 点击「生成新密钥」，复制生成的 API Key（格式：fk_live_xxxxxx）

安全提示：API Key 应妥善保管，切勿在前端代码或公开仓库中暴露。建议通过服务端代理调用风控API。

三、第二步：配置风控规则

在调用风控API之前，需要先在控制台配置风控策略。风控云提供可视化的规则引擎，无需编写代码即可完成配置：

创建产品（业务场景）

在控制台创建一个产品，定义业务场景。例如创建名为 order_check 的产品，用于电商订单风控。

配置风控规则

在产品下添加风控规则，常见的电商风控规则包括：

  • 同一收货地址24小时内下单超过5次 → 标记为可疑
  • 订单金额异常偏高（超过历史均值3倍） → 转人工审核
  • IP地址命中高风险地区库 → 提升风险评分
  • 手机号命中黑名单 → 直接拦截

设置决策阈值

配置风险评分的决策阈值，例如：

  • 评分 0-300：自动通过（pass）
  • 评分 301-700：转人工审核（review）
  • 评分 701-1000：自动拦截（reject）

四、第三步：接入风控API

配置好规则后，就可以在业务代码中调用实时风控API了。以下是多种编程语言的接入示例：

Python 示例

python
import requests

API_KEY = "fk_live_your_api_key"
BASE_URL = "https://api.fengkong.cloud/api/v1"

def check_order_risk(order_data):
    """调用风控API进行订单风险评估"""
    response = requests.post(
        f"{BASE_URL}/risk/check",
        json={
            "productCode": "order_check",
            "appName": order_data["customer_name"],
            "appCell": order_data["phone"],
            "appIp": order_data["ip_address"],
            "amount": order_data["amount"]
        },
        headers={
            "Content-Type": "application/json",
            "X-API-Key": API_KEY
        },
        timeout=5  # 设置超时
    )

    result = response.json()
    decision = result["data"]["decision"]
    score = result["data"]["score"]

    if decision == "pass":
        # 低风险，自动放行
        process_order(order_data)
    elif decision == "review":
        # 中等风险，转人工审核
        send_to_review_queue(order_data, score)
    else:
        # 高风险，自动拦截
        reject_order(order_data, result["data"]["matchedRules"])

    return result

# 使用示例
order = {
    "customer_name": "张三",
    "phone": "13800001234",
    "ip_address": "120.26.1.1",
    "amount": 299.00
}
risk_result = check_order_risk(order)

Node.js 示例

javascript
const API_KEY = 'fk_live_your_api_key';
const BASE_URL = 'https://api.fengkong.cloud/api/v1';

async function checkOrderRisk(orderData) {
  const response = await fetch(`${BASE_URL}/risk/check`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY
    },
    body: JSON.stringify({
      productCode: 'order_check',
      appName: orderData.customerName,
      appCell: orderData.phone,
      appIp: orderData.ipAddress,
      amount: orderData.amount
    })
  });

  const result = await response.json();
  const { decision, score, matchedRules } = result.data;

  switch (decision) {
    case 'pass':
      await processOrder(orderData);
      break;
    case 'review':
      await sendToReviewQueue(orderData, score);
      break;
    case 'reject':
      await rejectOrder(orderData, matchedRules);
      break;
  }

  return result;
}

// Express 中间件示例
app.post('/api/orders', async (req, res) => {
  const riskResult = await checkOrderRisk(req.body);
  if (riskResult.data.decision === 'reject') {
    return res.status(403).json({ error: '订单风险过高' });
  }
  // 继续处理订单...
});

curl 快速测试

bash
curl -X POST https://api.fengkong.cloud/api/v1/risk/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: fk_live_your_api_key" \
  -d '{
    "productCode": "order_check",
    "appName": "张三",
    "appCell": "13800001234",
    "appIp": "120.26.1.1",
    "amount": 299.00
  }'

更详细的接口文档请参考 风控云开发者文档。

五、接入最佳实践

1. 异步容错处理

当风控API出现超时或异常时，不应阻断正常业务流程。建议设置合理的超时时间（3-5秒），并在异常时采取默认放行 + 异步补审的策略。

2. 传递尽可能多的数据

向风控引擎传递更多维度的数据（如设备指纹、行为特征、历史订单数等），可以显著提升风险决策的准确性。

3. 监控与告警

关注风控系统的关键指标：拦截率、误伤率、审核量。设置告警阈值，当拦截率异常升高时及时排查。

4. 规则迭代优化

风控是一个持续优化的过程。定期回顾被拦截和被放行的案例，优化规则引擎中的策略参数，提升准确率。

5. 使用重试机制

对于暂时性错误（如网络抖动），实现指数退避重试策略。参考调用限制文档了解各版本的 QPS 限制。

六、常见问题

Q: 接入风控API会影响用户体验吗？

不会。风控云的实时风控API平均响应时间在15ms以内，最大不超过50ms，用户完全无感知。

Q: 免费版可以用于生产环境吗？

可以。免费版提供100次/月的API调用，适合测试和小规模业务。当业务增长时，可随时升级套餐。

Q: 支持哪些编程语言？

风控云提供标准 RESTful API，任何支持 HTTP 请求的编程语言都可以接入。文档提供了 Python、Node.js、Java、Go 等语言的示例代码。

立即开始接入

注册免费账号，获取 API Key，10分钟完成风控引擎接入。

免费注册 查看完整文档

相关阅读