1. 课程导论：实时交易风控的重要性、API 在风控系统中的角色、本课程目标与受众
1.1 实时交易风控：为什么是金融系统的生命线
在数字支付、开放银行与高频交易的驱动下，金融交易已进入毫秒级时代。一笔欺诈交易可能在 200 毫秒内完成资金转移，而传统事后对账或 T+1 风控模式完全无法拦截。实时交易风控（Real-time Transaction Risk Control）正是在交易发生的同时，通过规则引擎、机器学习模型与行为画像，在 50–100 毫秒内完成风险评分与决策。
| 维度 | 传统风控（事后） | 实时风控（在线） |
|---|---|---|
| 决策时间 | 分钟级 ~ T+1 | 50–100 ms |
| 数据来源 | 离线数仓、批量跑批 | 实时流、API 调用、设备指纹 |
| 拦截能力 | 事后追回，成功率低 | 事前阻断，资金零损失 |
| 典型场景 | 信用卡月结、对账 | 支付授权、转账、提现 |
关键指标： 根据行业报告，实时风控可将欺诈损失降低 70%–85%，同时将误杀率（False Positive Rate）控制在 0.5% 以下。每 10 毫秒的延迟增加，可能导致 1%–3% 的用户流失。
1.2 API 在风控系统中的核心角色
现代实时风控系统不再是单体架构，而是由多个微服务与外部数据源通过 API 协同组成。API 是风控系统的“神经末梢”，承担以下关键职责：
- 交易数据接入： 收单系统、网关、钱包通过统一 API 提交交易上下文（金额、设备、IP、地理位置）。
- 风险决策调用： 业务系统同步调用风控决策 API，在交易链路中嵌入评分与阻断逻辑。
- 第三方数据集成： 设备指纹、黑名单、征信、反洗钱（AML）等外部服务通过 API 注入特征。
- 结果异步回调： 异步审核、人工复核结果通过回调 API 通知业务方。
- 策略热更新： 运营后台通过管理 API 动态调整规则阈值、模型版本，无需重启服务。
1.3 本课程目标与受众
课程目标
完成本课程后，学员将能够独立设计、发布并集成一套生产级实时交易风控 API。具体包括：
- 理解实时风控的架构模式与 API 设计原则（RESTful / gRPC / 异步）。
- 掌握风控 API 的认证、限流、幂等、数据加密等安全规范。
- 能够编写 API 规范文档（OpenAPI 3.0）并生成 Mock 服务。
- 完成从 SDK 集成、联调测试到灰度上线的全流程。
- 建立 API 监控、告警与版本治理体系。
目标受众
| 角色 | 收益 |
|---|---|
| 后端 / 支付开发工程师 | 掌握风控 API 集成规范，减少联调返工 |
| 风控架构师 / 技术负责人 | 获得可落地的 API 治理与架构设计方法 |
| API 产品经理 / 技术文档工程师 | 学会编写高质量风控 API 文档与开发者体验优化 |
| 安全运维 / SRE | 理解风控 API 的监控、限流与灾备策略 |
前置要求： 建议学员具备至少 1 年 REST API 开发经验，了解 HTTP 协议、JSON 序列化与基本认证机制。无需风控领域背景，课程会从基础概念讲起。
1.4 课程特色与交付物
- 可运行代码： 每章附带 Spring Boot / Go 示例代码，可直接用于生产参考。
- API 规范文件： 完整的 OpenAPI 3.0 YAML 文件，支持导入 Postman / Swagger。
- 集成 Checklist： 从接入到上线的 40+ 项检查清单，避免遗漏。
- 真实案例： 支付机构、银行、电商平台的风控 API 集成复盘。
注意： 本课程不涉及具体风控模型算法（如 XGBoost、神经网络），重点聚焦 API 层设计、集成与运维。模型服务化调用会在模块三中作为外部 API 集成案例讲解。