V1.1 内部版内部系统
爱云科技

爱云科技 内部统一接口调用平台
整体开发手册

本文档是平台设计、数据库设计与系统开发的唯一权威依据，配套文档：《接口平台建设方案 V1.1（内部版）》（规划/接口清单/排期）与《平台原型 V1.1（内部版）》（交互与页面） 。所有模块、接口、表结构、错误码、流程均以本文档为准。

版本 V1.1编制 2026-08-31适用范围 爱云科技内部开发/测试/运维状态 评审稿
1
项目概述

明确平台定位、建设目标、范围边界与术语，作为所有设计与开发的前提。

🎯

定位

爱云科技内部技术中台：面向电商中台、智能小程序、客服系统、运营活动等业务线，统一供给认证、消息、增长三类接口能力，不对外商业化。

📐

建设目标

① 消除重复建设与重复采购；② 统一身份（企业微信 SSO）与安全治理；③ 配额与成本透明核算（分摊到业务线）；④ 业务线最快小时级接入。

📏

范围界定

做：API 网关/鉴权/计量/控制台/认证/消息/增长/成本核算。不做：对外售卖、发票、公网开发者注册、多租户商业化定价。

术语表

术语定义
业务线 Business Line公司内部独立业务组织（如电商中台、客服系统），是资源隔离与成本核算的最小单位，拥有业务线管理员。
应用 Application业务线下创建的内部应用（一个应用可包含多个服务），持有独立 AK/SK 与配额。
AK / SKAccess Key（标识）与 Secret Key（签名密钥）。SK 仅在创建时明文展示一次，库中仅存哈希。
配额 Quota应用在某周期（默认自然月）内对某 API 的调用上限，超额策略：告警 / 拒绝。
成本分摊按各业务线实际用量 × 内部成本单价折算，月度报表同步财务。
沙箱 Sandbox联调环境，调用真实服务但走 Mock 通道、不产生真实费用、不占用配额。
Webhook / 事件回调平台异步推送（短信回执等）到业务方 URL，带签名、幂等、重试。
幂等键 Idempotency-Key业务方生成的唯一键，平台用于重复请求去重（同一键只生效一次）。
traceId一次调用全链路唯一标识，贯穿网关 → 服务 → 通道 → 日志。
2
总体架构

四层架构 + 统一身份底座；内网部署，外部通道（短信/外呼）经安全网关统一出网。

层次组件职责
接入层内部 API 网关（APISIX/Kong）、统一鉴权、限流熔断、沙箱路由AK/SK 签名校验、IP 白名单、按业务线授权、配额前置校验、traceId 生成、灰度路由
业务服务层认证中心、消息中心、触达中心、增长中心、数据服务各能力域微服务，独立仓库独立部署，内部通过网关/内部 RPC 互联
平台服务层控制台、配额与成本、监控告警、内部运营Key/应用/审批/统计/成本报表/告警/工单/文档
基础设施层统一身份（企微/AD）、MySQL、Redis、MQ、ES、对象存储、私有云 K8s、安全网关数据、缓存、异步、检索、部署、外部通道出网

关键调用链路（一次 API 调用）

业务方→ 网关验签 / 限流 / 配额→ 业务服务→ 外部通道→ 异步回执→ MQ → 计量入库→ Webhook 推送业务方
POST /v1/sms/send HTTP/1.1
-- 网关处理顺序 --
1. 校验 X-AK、X-Timestamp（±300s）、X-Nonce、X-Signature（HMAC-SHA256）
2. 校验 IP 白名单 & 应用状态 & 环境（沙箱/生产）
3. 限流（令牌桶，默认 1000 QPS/应用）→ 配额前置检查（超额且策略=拒绝则 4xx）
4. 生成 traceId，路由到 sms-service
5. 业务服务写库 + 异步推送通道 + 记录回执任务
6. 计量：成功/失败/时延 异步写入 api_call_log 与日汇总
7. 回执到达 → 更新记录 → 按订阅推送 Webhook（幂等+重试）
微服务划分：auth-service（SSO/OAuth/验证码/实名）、msg-service（短信/邮件）、push-service（推送/站内信）、notify-service（Webhook/机器人）、growth-service（短链/二维码）、call-service（外呼）、chat-service（客服机器人）、data-service（数据/内容安全）、console-service（控制台）、billing-service（计量/配额/成本）、alert-service（告警）。
3
接口规范（公共约定）

所有 API 必须遵守的统一规范，接入前先完成签名与错误码认知。

3.1 接入流程

企微扫码登录→ 创建业务线应用（审批）→ 获取 AK/SK→ 沙箱联调→ 申请配额（审批）→ 上线生产

3.2 签名算法（HMAC-SHA256）

// 请求头（沙箱环境另加 X-Env: sandbox）
X-AK: <AccessKey>
X-Timestamp: <毫秒时间戳>
X-Nonce: <随机串(≥16位)>
X-Signature: <签名>

// 签名字符串（body 为原始请求体，GET 无 body 时为空串）
stringToSign = X-Timestamp + "\n" + X-Nonce + "\n" + body
X-Signature = Base64( HMAC-SHA256( secretKey, stringToSign ) )

// 服务端校验：时间戳 ±300s、nonce 防重放（Redis 5min 去重）、签名比对（常量时间比较）
SK 安全：SK 只允许创建时明文展示一次；泄露后应立即在控制台轮换；平台检测到异地/异常调用自动告警并支持一键吊销。

3.3 统一响应体与错误码

错误码段含义示例
0成功data 返回业务数据
1xxx鉴权类10001 签名无效 / 10002 时间戳过期 / 10003 AK 不存在或已禁用 / 10004 IP 不在白名单
2xxx参数类20001 参数缺失 / 20002 参数格式错误 / 20003 手机号不合法
3xxx业务类30001 验证码错误 / 30002 验证码过期 / 30003 模板审核中 / 30004 配额不足
4xxx限流与频率40001 触发限流 / 40002 触发频控（验证码 60s 重发限制）
5xxx系统类50001 内部错误 / 50002 通道异常（业务方应重试）
{ "code": 0, "msg": "ok", "data": { ... }, "traceId": "c9f3..." }

3.4 幂等 / 限流 / Webhook 约定

项约定
幂等写操作（send/verify/create 类）支持请求头 Idempotency-Key；同键重复请求返回首次结果（缓存 24h）。
限流默认 1000 QPS/应用（可在配额中心调整）；单号码短信频控：验证码 60s/条、同一号码 10 条/天。
Webhook 回调推送头：X-Signature: HMAC-SHA256(secret, body)；业务方须验签并响应 2xx；失败重试 1/5/30min 共 3 次；消息体含 eventId 供业务方幂等去重。
敏感字段响应默认脱敏（手机号 138****1234）；全量明文仅授权接口返回。
4
数据库设计（核心表结构）

共 6 个域、45 张核心表。公共字段：id BIGINT PK AUTO_INCREMENT、created_at/updated_at DATETIME、deleted_at DATETIME NULL（软删，日志/计量表除外）。金额单位统一为分（BIGINT）。手机号等敏感字段加密存储（AES-256-GCM，密钥由 KMS 管理），索引字段做 hash 索引（如 phone_hash）。下表仅列关键字段，完整 DDL 以数据库设计阶段产出为准。

4.1 平台基础域 7 表 · 控制台/网关依赖

business_line
业务线
idBIGINT主键
codeVARCHAR(32)唯一编码，如 ecommerce
nameVARCHAR(64)名称：电商中台
owner_useridVARCHAR(64)业务线负责人（企微 userid）
cost_center_noVARCHAR(32)成本中心编码
statusTINYINT1启用 0停用（索引）
platform_user
内部用户（同步自企微）
idBIGINT主键
wx_useridVARCHAR(64)企微 userid（唯一索引）
emp_noVARCHAR(32)工号
nameVARCHAR(32)姓名
deptVARCHAR(128)部门路径
statusTINYINT在职/离职
role / user_role / permission / role_permission
RBAC 权限四件套
role.idBIGINT角色：platform_admin / biz_admin / developer / auditor
user_role关联user_id + role_id + business_line_id（业务线级授权）
permissionVARCHAR(64)权限点：api:key:create / quota:apply / report:view…
role_permission关联role_id + permission_code
application
内部应用
idBIGINT主键
biz_line_idBIGINT所属业务线
app_keyVARCHAR(32)应用标识（唯一）
nameVARCHAR(64)应用名
envENUMsandbox / production
owner_useridVARCHAR(64)应用负责人
approval_statusTINYINT0草稿 1审批中 2通过 3驳回
app_apikey
AK/SK 凭证
idBIGINT主键
akVARCHAR(32)AccessKey（唯一索引）
sk_hashCHAR(64)SK 的 SHA-256（不明文存）
app_idBIGINT所属应用
envENUMsandbox / production
ip_whitelistJSONIP/CIDR 白名单
statusTINYINT正常/禁用/临期；expire_at DATETIME
api_catalog
API 目录（全平台唯一入口）
idBIGINT主键
serviceVARCHAR(32)所属微服务
pathVARCHAR(128)如 /v1/sms/send
methodVARCHAR(8)GET/POST/PUT/DELETE
domainVARCHAR(16)auth/msg/push/notify/growth/…
priorityCHAR(2)P0/P1/P2
statusTINYINT0草稿 1已开放 2灰度中 3下线
unit_costBIGINT内部成本单价（分）
sys_config
系统配置 KV
kVARCHAR(64)键（唯一）
vTEXTJSON 值
descVARCHAR(128)说明

4.2 配额与计量域 4 表 · 计费/统计核心

app_api_quota
应用×API 配额
idBIGINT主键
app_idBIGINT应用
api_idBIGINTAPI
periodENUMmonth（默认）/ day / hour
limit_amountBIGINT周期限额
over_policyTINYINT1告警 2拒绝（默认告警）
uk唯一app_id+api_id+period
quota_usage
配额用量（按日累计）
idBIGINT主键
app_idBIGINT应用
api_idBIGINTAPI
stat_dateDATE统计日
cntBIGINT当日成功计数（小时列可扩展）
uk唯一app_id+api_id+stat_date
api_call_log
调用日志（大表 · 按日分表/归档）
idBIGINT主键（可改雪花）
trace_idVARCHAR(32)全链路 ID（索引）
app_id / api_idBIGINT应用与 API
biz_line_idBIGINT业务线（成本分摊维度）
envENUMsandbox / production
result_codeINT0 成功 / 错误码 / 限流 40001
latency_msINT时延
client_ipVARCHAR(46)来源 IP
request_body_hashCHAR(64)body 摘要（不存明文敏感数据）
api_call_metric_daily
日汇总（统计/报表读取源）
stat_dateDATE统计日
app_id / api_id / biz_line_idBIGINT维度
ok_cnt / err_cnt / limited_cntBIGINT成功/失败/限流
total_latencyBIGINT时延累计（算 P95/P99）
uk唯一stat_date+app_id+api_id

4.3 认证域 5 表

sso_session
SSO 会话
ticketVARCHAR(64)授权票据（唯一，Redis 为主存）
user_idBIGINT用户
client_idVARCHAR(64)业务系统
expire_atDATETIME过期（默认 2h）
logout_atDATETIME全局退出时间
oauth_client / oauth_token
OAuth2 客户端与令牌
oauth_client—client_id/secret_hash/grant_types/redirect_uris(JSON)/scopes
oauth_token—access_token_hash/refresh_token_hash/type/expire/scope/user_id（均哈希存储）
sms_verify_code
短信验证码
phone_hashCHAR(64)手机号哈希（索引）
sceneVARCHAR(32)login/register/reset…
code_hashCHAR(64)验证码哈希
expire_atDATETIME5min 有效
retry_cntTINYINT已重试次数（上限 5）
consumedTINYINT是否已消费
realname_record
实名/企业认证记录（合规）
user_idBIGINT用户
typeTINYINT1个人 2企业
id_no_encVARBINARY身份证号（AES 加密）
verify_resultTINYINT0待审 1通过 2拒绝
channel_traceVARCHAR(64)通道流水号

4.4 消息域 9 表

sms_template
短信模板
biz_line_idBIGINT所属业务线
typeTINYINT1验证码 2通知 3营销（营销强制退订）
contentTEXT内容（含 {var} 变量）
audit_statusTINYINT0草稿 1审核中 2通过 3驳回（内部审核）
channel_codeVARCHAR(32)通道商模板编码
sms_send_task / sms_send_record
短信发送任务与明细
task—batch_no/app_id/template_id/total_cnt/status/created_by
record—task_id/phone_hash/template_params(JSON)/send_status/回执 deliver_status(SUCCESS/FAIL)/channel_msg_id
索引—phone_hash、task_id、channel_msg_id（回执匹配）
email_template / email_send_task
邮件模板与发送
email_template—name/subject_html/body_html/vars(JSON)/status
email_send_task—batch_no/subject/from/send_cnt/bounce_cnt/status
push_app_config / push_send_record
推送应用与发送记录
push_app_config—app_name/channels(JSON: APNs/FCM/华为/小米/OPPO/vivo 凭证加密)
push_send_record—push_app_id/device_token_hash/title/body/route_status/厂商回执
inapp_message
站内信
app_idBIGINT来源应用
target_userVARCHAR(64)接收用户 ID
title / content—内容
read_atDATETIME已读时间（NULL=未读）
webhook_subscription / webhook_delivery_log
事件订阅与投递
subscription—app_id/event_type/url/secret_hash/status
delivery_log—event_id(幂等键)/sub_id/payload(JSON)/http_code/retry_cnt/next_retry_at/status
bot_config
机器人配置（钉钉/企微/飞书）
biz_line_idBIGINT业务线
platformENUMdingtalk/wecom/feishu
webhook_encVARBINARYWebhook 地址（加密）
secret_encVARBINARY加签密钥（加密）

4.5 增长域 6 表

short_link
短链接
idBIGINT主键
short_codeVARCHAR(16)短码（唯一，跳转主键）
long_urlVARCHAR(2048)原始长链
app_idBIGINT创建应用
expire_atDATETIME过期时间（NULL=永久）
pwd_hashCHAR(64)访问密码哈希（可选）
short_link_visit_log
短链访问日志（统计源）
link_idBIGINT短链
visit_timeDATETIME访问时间
ip / ua / referer—来源信息
索引—link_id+visit_time（PV/UV/来源统计）
callout_task / callout_record
智能外呼
task—app_id/template_id/batch_no/total/status/schedule_at
record—task_id/phone_hash/state(未呼/接通/未接/挂断)/duration/record_url/transcript
chatbot_kb
客服知识库
app_idBIGINT所属应用
doc_typeTINYINT1FAQ 2文档 3富文本
question / answerTEXT问答内容
statusTINYINT训练中/已生效/下线
chatbot_session
对话会话（多轮上下文）
session_idVARCHAR(64)会话 ID
app_id / user_id—维度
contextJSON多轮上下文
handoffTINYINT是否已转人工

4.6 平台运营域 7 表 · 审批/告警/审计/工单/成本

approval
审批单（统一审批流）
biz_typeVARCHAR(32)app_create / key_create / quota_apply / key_revoke
apply_user / apply_biz_line—申请人
payloadJSON申请内容快照
statusTINYINT0待审 1通过 2驳回 3撤销
approved_by / approved_at / comment—审批人/时间/意见
alert_rule / alert_event
告警规则与事件
alert_rule—metric(成功率/时延/配额余量/QPS)/threshold/notify_channels(JSON)/enabled
alert_event—rule_id/app_id/level/value/triggered_at/recovered_at
audit_log
审计日志（不可修改）
operatorVARCHAR(64)操作人（企微 userid）
actionVARCHAR(64)动作：key.create / quota.update…
targetVARCHAR(128)对象
detailJSON前后变更
ip / created_at—来源与时间（只追加）
workorder
内部工单
title / content—内容
creator / assignee—创建/处理人
statusTINYINT0待受理 1处理中 2已解决 3已关闭
sla_dueDATETIME响应 SLA（4h）
unit_cost
成本单价（来自采购合同）
api_idBIGINTAPI
effective_dateDATE生效日
unit_priceBIGINT单位成本（分）
sourceVARCHAR(128)来源合同/通道价
cost_settlement_monthly
月度成本分摊（只读结果）
stat_monthCHAR(7)如 2026-08
biz_line_id / api_idBIGINT维度
usage_cntBIGINT用量
amountBIGINT分摊金额（分）
statusTINYINT0生成中 1已确认 2已同步财务
5
安全与权限设计

统一身份 + RBAC + 密钥生命周期 + 数据安全，满足内部最小权限与审计要求。

👤

企业微信 SSO

控制台登录：企微扫码 → 企微 OAuth 授权 → 平台拉取 userid/工号/部门 → 映射本地 platform_user → 下发会话。业务系统接入 SSO 复用同一体系，全平台免登。

🧑‍💼

角色定义（RBAC）

platform_admin：全平台管理与审批；biz_admin：本业务线应用/Key/配额审批与查看；developer：创建应用、沙箱联调、申请配额；auditor：只读审计与成本报表。

🔑

密钥生命周期

创建（一次性展示 SK）→ 使用 → 轮换（新旧并存 24h 过渡）→ 吊销（立即生效 + 审计）→ 自动失效（到期/离职）。异常调用自动告警。

数据安全基线：① 敏感字段（手机号/身份证/凭证）AES-256-GCM 加密存储，KMS 管钥；② 接口响应默认脱敏；③ 生产环境仅内网可达，外部通道走安全网关；④ 审计日志只追加、防篡改；⑤ 离职员工账号即时禁用并吊销其名下密钥。
6
配额与成本核算设计

内部版替代"商业计费"的核心机制：配额管用量、成本管分摊。

配额模型

项设计
配额粒度应用 × API × 周期（默认自然月；支持日/小时粒度的保护性限额）
默认值新应用默认按目录默认配额（如短信 300 万条/月）；超量需走审批调额
超额策略告警（默认，超额仅告警不断供）/ 拒绝（返回 30004，需审批解锁）
计量链路网关计量 → MQ 异步 → quota_usage 按日累计 + Redis 实时计数（网关前置检查用）

成本核算流程

调用计量（T+0）→ 日汇总 api_call_metric_daily→ 月度任务：用量 × unit_cost→ cost_settlement_monthly 分摊→ 业务线负责人确认→ 同步财务
对账要求：计量与成本解耦——成本以日汇总表为准重新计算，防止源表被改导致金额漂移；每月 1 日生成上月报表，业务线 3 日内确认，异议走工单复核。
7
控制台功能清单

页面清单供原型图设计直接引用；每页标注核心数据来源表与关键交互。

页面功能点数据来源
登录企微扫码登录、SSO 跳转、角色识别platform_user / user_role
工作台今日调用量/成功率/配额余量/告警；业务线 TOP 排行api_call_metric_daily / quota_usage / alert_event
能力中心API 目录浏览（分类/状态/配额信息）、沙箱调试入口api_catalog / app_api_quota
应用管理创建应用（提交审批）、应用列表、成员application / approval
Key 管理申请/轮换/吊销、IP 白名单、环境切换app_apikey / approval / audit_log
调用统计按 API/业务线/时间/状态码多维分析、明细下载api_call_metric_daily / api_call_log
配额与成本配额查看/调额申请、超额策略设置、成本月报app_api_quota / cost_settlement_monthly
告警中心规则配置、事件列表、恢复记录alert_rule / alert_event
审批中心待办/已办、同意/驳回、审批链approval
审计日志操作查询（auditor 只读）audit_log
工单支持提工单、SLA 响应、状态流转workorder
开发文档接入指引、签名工具、SDK 下载、错误码静态内容 / sys_config
8
工程规范

技术栈、仓库结构、编码规范，供系统开发阶段直接执行。

技术栈选型

层选型
网关Apache APISIX（鉴权/限流/配额插件自研）或 Kong
后端Java 17 + Spring Cloud / Go（按服务选型，建议 auth/console 用 Java，网关插件与 data 服务用 Go）
前端Vue 3 + TypeScript + Vite + Element Plus（控制台），响应式适配
存储MySQL 8.0（主库，读写分离）、Redis 7（缓存/频控/计数）、Elasticsearch（日志检索）、MQ（RocketMQ/Kafka）、对象存储（文件）
部署私有云 K8s + Helm；CI/CD：GitLab CI / Jenkins；可观测：Prometheus + Grafana + SkyWalking

仓库与命名规范

# 独立仓库（推荐）：aiyun/ 组下按服务建仓
aiyun-gateway / aiyun-console / aiyun-auth-service / aiyun-msg-service /
aiyun-push-service / aiyun-notify-service / aiyun-growth-service /
aiyun-call-service / aiyun-chat-service / aiyun-data-service /
aiyun-billing-service / aiyun-alert-service / aiyun-sdk-java / aiyun-sdk-python

# 分支模型：main（可发布）→ release/x.y（发布）→ feature/xxx、fix/xxx、hotfix/xxx
# 提交规范：(): ，如 feat(sms): add template audit callback

代码与接口开发要求

📐 接口开发清单

每新增接口必须：① 在 api_catalog 登记；② 网关插件注册路由与权限；③ 错误码在统一表登记；④ 写 OpenAPI 文档；⑤ 补充 SDK 方法；⑥ 定义成本单价。

🔍 日志要求

全链路 traceId 透传；业务日志含 app_id/api_id/result_code/latency；禁止记录明文手机号/身份证；敏感字段打码后入日志。

⚙️ 配置管理

配置走 Nacos/K8s ConfigMap；密钥/凭证入 KMS 或 Vault，禁止硬编码与提交仓库。

9
测试与上线规范

测试分层、环境管理、CI/CD 与上线检查清单。

阶段要求
单元测试核心服务覆盖率 ≥ 70%；签名、幂等、配额策略必测
接口/契约测试网关层契约测试（签名/错误码/响应体）；Consumer-Driven 契约防服务间破坏
集成测试沙箱环境全链路：业务方应用 ↔ 网关 ↔ 服务 ↔ Mock 通道
性能压测目标：单应用 1000 QPS、P95 < 200ms、网关吞吐 ≥ 1 万 TPS；压测报告随发布评审
安全测试签名绕过/重放、越权（跨业务线）、敏感数据泄露、注入；上线前渗透测试

上线检查清单

  • □ 接口已在 api_catalog 登记并配置成本单价与默认配额
  • □ 网关路由/鉴权/限流/配额插件已配置并通过契约测试
  • □ 错误码、OpenAPI、SDK、控制台文档已同步
  • □ 审计、监控大盘、告警规则（成功率/时延/配额余量）已就绪
  • □ 压测达标 + 安全扫描无高危 + 数据加密与脱敏已验证
  • □ 灰度策略确认（首批业务线名单 + 回滚方案）
10
运维与监控

黄金指标、告警建议、日志链路与容量规划。

可用性月目标 ≥ 99.95%
P95 时延< 200ms
调用成功率告警阈值 < 99.9%
配额余量告警阈值 < 20%

📡 监控指标

RED 四件套：请求量、错误率、时延（P50/P95/P99）、饱和度（QPS/连接/磁盘）。按 app_id 与业务线拆分看板。

🚨 告警建议

成功率 <99.9%（5min）；P95 >300ms；配额余量 <20%；余额/通道可用性；发送到企微告警群 + Webhook。

🗄️ 容量与备份

api_call_log 按日分表、30 天归档至冷存；MySQL 主从 + 每日备份 + 每月恢复演练；Redis 集群哨兵。

11
里程碑与交付计划（16 周）

对应建设方案 V1.1 的 5 个里程碑；每个里程碑出口须可演示、可配额、可灰度。

里程碑周期交付内容责任人角色
M1 平台基座第 1–2 周网关+签名+限流；企微 SSO 登录；应用/Key 管理；控制台框架；SDK 骨架网关/后端/前端
M2 认证与消息核心第 3–6 周SSO/OAuth2 全链路；短信+验证码+模板审核；Webhook；统计+配额 V1auth/msg/网关
M3 消息扩展第 7–9 周邮件；推送聚合；站内信；机器人；告警订阅push/notify
M4 增长与合规第 10–12 周短链+二维码；内容安全；文件服务；配额与成本 V2（月报）growth/data/billing
M5 智能与全量第 13–16 周外呼；客服机器人；一键登录/实名（按需）；灰度 2–3 业务线 → 压测/审计 → 全量call/chat/平台
12
附录

12.1 API 清单速查（40+）

模块接口说明方法优先级
SSO/v1/sso/authorize发起授权（企微对接）GETP0
/v1/sso/token换令牌POSTP0
/v1/sso/userinfo用户信息GETP0
/v1/sso/logout全局退出POSTP0
一键登录/v1/onepass/preget预取号POSTP2
/v1/onepass/verify取号校验POSTP2
OAuth2/v1/oauth/authorize授权码端点GETP0
/v1/oauth/token令牌端点POSTP0
/v1/oauth/revoke令牌撤销POSTP0
实名/v1/realname/verify要素核验POSTP2
/v1/realname/face人脸+活体POSTP2
企业认证/v1/enterprise/verify四要素核验POSTP2
/v1/enterprise/ocr执照 OCRPOSTP2
验证码/v1/sms/verify验证码校验POSTP0
短信/v1/sms/send单条发送POSTP0
/v1/sms/batch批量群发POSTP0
/v1/sms/status状态查询GETP0
/v1/sms/template模板管理POSTP0
邮件/v1/email/send单发POSTP1
/v1/email/batch群发POSTP1
/v1/email/template模板管理POSTP1
推送/站内信/v1/push/send /v1/inapp/send聚合推送 / 站内信POSTP1
Webhook/v1/webhook/subscribe事件订阅POSTP0
机器人/v1/bot/dingtalk /v1/bot/wecom /v1/bot/feishu群机器人消息POSTP1
短链/v1/surl/create创建短链POSTP1
/v1/surl/stats访问统计GETP1
/v1/surl/qrcode短链转二维码GETP1
二维码/v1/qrcode/create /v1/qrcode/decode生成 / 解析POSTP1
外呼/v1/callout/start发起外呼POSTP2
/v1/callout/status状态查询GETP2
/v1/callout/record录音转写GETP2
客服机器人/v1/chatbot/message对话POSTP2
/v1/chatbot/kb知识库POSTP2
/v1/chatbot/handoff转人工POSTP2
内容安全/v1/censor/text /v1/censor/image文本/图片审核POSTP1
数据服务/v1/data/phone-locate /v1/data/ip-locate归属地查询GETP2
文件/v1/file/upload对象存储上传POSTP1

12.2 配套文档关系

文档用途下一步产出
本《整体开发手册》开发/数据库/测试/上线统一依据—
《建设方案 V1.1》规划、接口清单、排期背景PRD 细化
《平台原型 V1.1》交互与页面参考高保真原型图（Figma）
数据库设计（待产出）本手册 §4 扩展为完整 DDL/ER 图Flyway 迁移脚本
接口详情（待产出）§3 + §12 扩展为 OpenAPI 3.0SDK 自动生成
爱云科技 · 内部统一接口调用平台 · 整体开发手册 V1.1（内部版）· 2026-08-31
本手册为爱云科技内部资料，请勿外传；与《建设方案 V1.1》《平台原型 V1.1》配套使用