---
name: api-integration-plan
when: '接口对接方案, 第三方对接, API集成方案'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-artifact_template-接口对接方案模版
asset_kind: acceptance_template
lifecycle_status: active
owner_mechanism_id: mc-generic-artifact
authority: supporting
routes:
  - '*'
primary_triggers:
  - 接口对接方案
  - 第三方对接
  - API集成方案
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits:
  - acceptance_report
secondary_triggers: []
negative_triggers: []
type: acceptance_template
stages: ["架构设计", "详细设计"]
---

# 接口对接方案

## 1. 第三方服务概况
- 服务名称：
- 服务类型（支付/通知/数据/认证）：
- SLA 可用性：
- 沙箱环境地址：

## 2. 认证方式
- 认证类型（API Key / OAuth / Token / 签名）：
- 密钥管理方案（加密存储/环境变量/密钥轮换）：

## 3. 接口清单
| 接口 | 方法 | 路径 | 用途 | 调用频率 |
|------|------|------|------|---------|
| | | | | |

## 4. 数据映射
| 我方字段 | 我方类型 | 对方字段 | 对方类型 | 转换规则 |
|---------|---------|---------|---------|---------|
| | | | | |

## 5. 错误码映射
| 对方错误码 | 含义 | 我方错误码 | 用户提示 | 处理策略 |
|-----------|------|-----------|---------|---------|
| | | | | |

## 6. 容错策略
- 超时时间：
- 重试次数 + 退避策略：
- 熔断阈值：
- 降级方案：
- 限流/配额：

## 7. Mock 方案
- 本地 Mock 方式：
- 沙箱对接计划：
