第三方 API 对接向导（专业版）
输入
| 字段 | 必填 | 说明 |
|---|---|---|
| platform | 是 | 平台名 |
| scenario | 是 | 集成场景 |
输出
五段式对接流程 + Webhook验签要点 + 人工确认项
Python 引擎（可独立运行）
# -*- coding: utf-8 -*-
CATALOG = {
"微信": ("IM/支付", ["注册服务号/商户号", "获取AppID/AppSecret", "换取access_token", "调用消息/支付接口", "回调验签(微信签名算法)"]),
"飞书": ("办公", ["创建企业自建应用", "获取AppID/AppSecret", "获取tenant_access_token", "调用消息/审批接口", "事件订阅+签名校验"]),
"钉钉": ("办公", ["注册企业应用", "获取AppKey/AppSecret", "获取access_token", "调用消息/审批接口", "回调+验签"]),
"支付宝": ("支付", ["注册开放平台应用", "获取APPID/密钥", "RSA签名鉴权", "调用支付接口", "异步通知验签"]),
"抖音": ("内容/电商", ["注册开放平台", "获取client_key/client_secret", "获取access_token", "调用内容/订单接口", "webhook+验签"]),
}
def gen_steps(platform, scenario):
if platform not in CATALOG:
return None, "平台不在内置目录，请确认平台名或按官方文档手动对接"
cat, steps = CATALOG[platform]
return {"platform": platform, "category": cat, "scenario": scenario,
"steps": steps, "confirm": ["实名认证", "审核时长", "费率(以官方为准)"]}, "OK"
def validate_webhook(text):
keys = ["验签", "签名", "回调", "token"]
missing = [k for k in keys if k not in text]
if missing:
return False, f"Webhook流程缺: {missing}"
return True, "验签要点齐全"
硬性规则
- 平台不在内置目录 → 明确提示，不硬猜流程
- 费率/审核时长标"以官方为准"，不编造
- Webhook 必须含验签/签名/回调三要素，否则校验不通过
示例
gen_steps("飞书", "消息推送") → category=办公, steps含tenant_access_token+事件订阅验签；validate_webhook通过
