套餐设计
系统运行稳定,用户持续增长。
Admin Dashboard
最近调用记录
5 条| 时间 | 方法 | API 路径 | IP 地址 | 状态码 | 延迟 |
|---|---|---|---|---|---|
2026-08-03 11:40:18 | POST | /api/v1/usage/report | 10.21.3.8 | 200 | 82ms |
2026-08-03 11:40:13 | GET | /api/v1/weather?city=xian | 10.21.3.5 | 200 | 27ms |
2026-08-03 11:40:09 | GET | /api/v1/weather?city=wuhan | 10.21.3.2 | 200 | 30ms |
2026-08-03 11:40:05 | POST | /api/v1/billing_reconciliation/preview | 10.21.3.14 | 200 | 95ms |
2026-08-03 11:40:00 | GET | /api/v1/weather?city=tianjin | 10.21.3.11 | 200 | 29ms |
但运营团队找到我:
运营团队提出了需求:
我调研了竞品的定价策略:
竞品分析
竞品 A 定价:
- 免费版:100 次/天
- 基础版:¥99/月,10000 次/天
- 专业版:¥499/月,100000 次/天
- 企业版:联系销售
竞品 B 定价:
- 免费版:1000 次/月
- 基础版:¥49/月,50000 次/月
- 专业版:¥199/月,500000 次/月
- 企业版:¥999/月,无限制
我的定价策略
基于成本分析和竞品调研,我设计了这样的套餐:
| 特性 | 免费版 | 基础版 | 专业版 | 企业版 |
|---|---|---|---|---|
| 价格 | ¥0/月 | ¥99/月 | ¥499/月 | 定制 |
| 每日限额 | 1000 次 | 10000 次 | 100000 次 | 无限制 |
| 每秒限额 | 1 次/秒 | 10 次/秒 | 100 次/秒 | 1000 次/秒 |
| 突发容量 | 10 次 | 100 次 | 1000 次 | 10000 次 |
| API 数量 | 3 个 | 10 个 | 所有 | 所有 |
| 数据保留 | 7 天 | 30 天 | 90 天 | 永久 |
| 技术支持 | 社区 | 邮件 | 邮件+IM | 专属经理 |
| SLA 保证 | 无 | 99.5% | 99.9% | 99.95% |
| 自定义域名 | ❌ | ❌ | ✅ | ✅ |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | PRIMARY KEY, AUTO_INCREMENT |
endpoint | VARCHAR(255) | NOT NULL |
params | TEXT | 请求参数 |
response_status | INT | HTTP 状态码 |
response_time | INT | 响应时间(ms) |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| id | endpoint | params | response_status | response_time | created_at |
|---|---|---|---|---|---|
1 | /api/weather | city=北京 | 200 | 118 | 2026-03-31 14:00:00 |
2 | /api/weather | city=上海 | 200 | 132 | 2026-03-31 14:01:00 |
3 | /api/weather | city=广州 | 500 | 240 | 2026-03-31 14:02:00 |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | INT | PRIMARY KEY, AUTO_INCREMENT |
email | VARCHAR(255) | UNIQUE, NOT NULL |
password_hash | VARCHAR(255) | NOT NULL |
api_key | VARCHAR(64) | UNIQUE, NOT NULL |
plan | VARCHAR(50) | DEFAULT 'free' |
daily_limit | INT | DEFAULT 1000 |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| id | plan | daily_limit | created_at | |
|---|---|---|---|---|
1 | alice@demo.com | free | 1000 | 2026-04-08 10:32:11 |
2 | bob@demo.com | pro | 100000 | 2026-04-11 09:15:02 |
3 | ops@demo.com | basic | 10000 | 2026-04-13 21:44:36 |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | PRIMARY KEY, AUTO_INCREMENT |
user_id | INT | NOT NULL |
endpoint | VARCHAR(255) | NOT NULL |
hour | TIMESTAMP | 精确到小时 |
total_calls | INT | DEFAULT 0 |
success_calls | INT | DEFAULT 0 |
error_calls | INT | DEFAULT 0 |
avg_response_time | FLOAT | 平均响应时间(ms) |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| user_id | endpoint | hour | total_calls | success_calls | error_calls |
|---|---|---|---|---|---|
1001 | /api/weather | 2026-04-20 10:00 | 132 | 128 | 4 |
1002 | /api/forecast | 2026-04-20 10:00 | 91 | 90 | 1 |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | PRIMARY KEY, AUTO_INCREMENT |
user_id | INT | NOT NULL |
endpoint | VARCHAR(255) | NOT NULL |
date | DATE | 统计日期 |
total_calls | INT | DEFAULT 0 |
success_calls | INT | DEFAULT 0 |
error_calls | INT | DEFAULT 0 |
avg_response_time | FLOAT | 平均响应时间(ms) |
p95_response_time | FLOAT | 95分位响应时间(ms) |
p99_response_time | FLOAT | 99分位响应时间(ms) |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| user_id | endpoint | date | total_calls | success_calls | error_calls |
|---|---|---|---|---|---|
1001 | /api/weather | 2026-04-20 | 2410 | 2368 | 42 |
1002 | /api/forecast | 2026-04-20 | 1832 | 1810 | 22 |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | PRIMARY KEY, AUTO_INCREMENT |
user_id | INT | NOT NULL |
month | DATE | 每月1号 |
total_calls | INT | DEFAULT 0 |
total_success | INT | DEFAULT 0 |
total_error | INT | DEFAULT 0 |
avg_daily_calls | FLOAT | 日均调用次数 |
peak_hour_calls | INT | 峰值小时调用量 |
most_used_endpoint | VARCHAR(255) | 最常调用接口 |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| user_id | month | total_calls | total_success | total_error | avg_daily_calls |
|---|---|---|---|---|---|
1001 | 2026-04 | 58420 | 57110 | 1310 | 1947 |
1002 | 2026-04 | 40680 | 39920 | 760 | 1356 |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | INT | PRIMARY KEY, AUTO_INCREMENT |
name | VARCHAR(100) | UNIQUE, NOT NULL |
display_name | VARCHAR(100) | NOT NULL |
endpoint | VARCHAR(255) | NOT NULL |
method | VARCHAR(10) | DEFAULT 'GET' |
category | VARCHAR(50) | weather/news/finance/tools |
external_api_url | VARCHAR(255) | 上游服务地址 |
requires_auth | BOOLEAN | DEFAULT TRUE |
cache_ttl | INT | 缓存时间(秒) |
rate_limit_factor | INT | DEFAULT 1 |
status | VARCHAR(20) | active/deprecated/maintenance |
is_public | BOOLEAN | DEFAULT TRUE |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
updated_at | TIMESTAMP | ON UPDATE CURRENT_TIMESTAMP |
| id | name | display_name | category | method | cache_ttl | status |
|---|---|---|---|---|---|---|
1 | weather | 天气查询 | weather | GET | 3600 | active |
2 | news | 新闻快讯 | news | GET | 300 | active |
3 | stock | 股票行情 | finance | GET | 60 | maintenance |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | INT | PRIMARY KEY, AUTO_INCREMENT |
user_id | INT | NOT NULL |
api_id | INT | NOT NULL, FK -> api_definitions.id |
granted_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
expires_at | TIMESTAMP | NULL 表示长期有效 |
status | VARCHAR(20) | active/revoked/expired |
| id | user_id | api_id | granted_at | expires_at | status |
|---|---|---|---|---|---|
8001 | 101 | 1 | 2026-04-10 10:00:00 | NULL | active |
8002 | 101 | 2 | 2026-04-10 10:00:00 | 2026-05-10 10:00:00 | active |
8003 | 204 | 3 | 2026-04-01 09:15:00 | 2026-04-30 23:59:59 | expired |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | NOT NULL, AUTO_INCREMENT |
user_id | INT | NOT NULL |
endpoint | VARCHAR(255) | NOT NULL |
params | TEXT | 请求参数 |
response_time | INT | 毫秒 |
status | VARCHAR(50) | 调用状态 |
created_at | TIMESTAMP | 分区键 |
pk | PRIMARY KEY(id, created_at) | 支持范围分区 |
| partition | range | records | storage | hotness |
|---|---|---|---|---|
p202401 | < 2024-02-01 | 58,200,000 | 370 GB | cold |
p202402 | < 2024-03-01 | 61,900,000 | 395 GB | warm |
pmax | MAXVALUE | ongoing | rolling | hot |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | BIGINT | NOT NULL |
user_id | INT | NOT NULL |
endpoint | VARCHAR(255) | NOT NULL |
response_time | INT | 毫秒 |
status | VARCHAR(50) | 调用状态 |
created_at | TIMESTAMP | 分层依据 |
storage_tier | VARCHAR(20) | hot/warm/cold |
archive_uri | VARCHAR(255) | 冷数据对象存储地址 |
| tier | time_range | query_freq | storage | cost_level |
|---|---|---|---|---|
hot | 0-30 days | high | MySQL 主库 | high |
warm | 30-180 days | medium | MySQL 从库 | medium |
cold | >180 days | low | 对象存储 | low |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | INT | PRIMARY KEY, AUTO_INCREMENT |
name | VARCHAR(50) | UNIQUE, free/basic/pro/enterprise |
display_name | VARCHAR(100) | 套餐展示名 |
price_monthly | DECIMAL(10,2) | 月费 |
daily_limit | INT | 每日配额 |
rate_limit_per_second | INT | 每秒限流 |
burst_capacity | INT | 突发容量 |
max_apis | INT | 可用 API 数量 |
data_retention_days | INT | 数据保留天数 |
support_type | VARCHAR(50) | community/email/priority/dedicated |
custom_domain | BOOLEAN | 是否支持自定义域名 |
created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP |
| id | name | price_monthly | daily_limit | rate_limit_per_second | support_type |
|---|---|---|---|---|---|
1 | free | 0.00 | 1000 | 1 | community |
2 | basic | 99.00 | 10000 | 10 | email |
3 | pro | 499.00 | 100000 | 100 | priority |
| 字段名 | 类型 | 约束 / 说明 |
|---|---|---|
id | INT | PRIMARY KEY, AUTO_INCREMENT |
user_id | INT | UNIQUE, FK -> users.id |
plan_id | INT | FK -> pricing_plans.id |
billing_cycle | VARCHAR(20) | monthly/yearly |
status | VARCHAR(20) | active/cancelled/expired/past_due |
current_period_start | TIMESTAMP | 当前周期开始 |
current_period_end | TIMESTAMP | 当前周期结束 |
cancel_at_period_end | BOOLEAN | 期末取消标记 |
payment_method_id | VARCHAR(255) | 支付渠道 ID |
updated_at | TIMESTAMP | ON UPDATE CURRENT_TIMESTAMP |
| id | user_id | plan_id | billing_cycle | status | current_period_end |
|---|---|---|---|---|---|
501 | 101 | 2 | monthly | active | 2026-05-31 23:59:59 |
502 | 204 | 3 | yearly | active | 2027-04-30 23:59:59 |
503 | 305 | 1 | monthly | past_due | 2026-04-30 23:59:59 |
套餐设计完只是第一步,真正把它变成产品的是这三个 API:用户能看到哪些套餐、自己现在是什么套餐、怎么升级或降级。它们的共同要求是幂等——同一个请求重复提交不能改两次账。
获取套餐列表
这个接口是定价页的数据来源,对所有用户开放。难点在可见性:免费用户不该看到企业版,而企业版的具体额度也不适合写死在代码里。
获取套餐列表
- 步骤 1:从套餐配置表读出所有在售套餐的定价、限额和功能开关
- 步骤 2:按调用方身份过滤可见套餐,例如免费用户不展示企业版
- 步骤 3:把每个套餐的额度换算成统一的限额对象,供前端展示和限流中间件共用
- 步骤 4:缓存套餐列表并带上版本号,套餐配置发生变更时让缓存失效
关注点:套餐可见性、限额对象的统一口径与配置变更时的缓存失效。
获取用户当前套餐
用户最常问的一句话是「我现在是什么套餐、还剩多少额度」。这个接口要在一次查询里同时给出套餐身份、计费周期和周期内已用量,否则前端还得再调好几个接口。
获取用户当前套餐
- 步骤 1:校验调用方的 API Key,并从中解析出对应的用户 ID
- 步骤 2:按用户 ID 读取订阅关系表,取出当前生效的套餐和本计费周期的起止时间
- 步骤 3:汇总周期内已用量一起返回,让用户随时知道自己还剩多少额度
关注点:订阅关系查询、计费周期边界与用量口径的一致性。
升级/降级套餐
这是整个计费链路里最容易出错的一步:钱付了但套餐没变,或者同一次操作被扣了两次款。所以顺序必须是先确认支付成功,再改订阅,最后异步刷新权益和限流。
升级/降级套餐
- 步骤 1:校验目标套餐是否存在,算出差价以及是立即生效还是下个周期生效
- 步骤 2:校验支付状态与回调结果,确认支付成功之后才写入订阅关系
- 步骤 3:更新订阅记录里的套餐 ID、周期起止时间和待生效变更,保证一个用户只有一条有效订阅
- 步骤 4:把变更事件写入队列异步刷新限流阈值与权益,并向用户返回明确的生效时间
关注点:支付确认与订阅写入的先后顺序、幂等性与生效时间。
快易查
天气查询 API
获取全球城市的实时天气信息,包括温度、湿度、天气状况等
/api/weather汇率转换 API
支持 150+ 种货币的实时汇率查询和转换
/api/exchangeIP 地址查询 API
根据 IP 地址获取地理位置、运营商等信息
/api/ip文本分析 API
情感分析、关键词提取、文本分类等 NLP 功能
/api/text/analyze二维码生成 API
自定义样式生成二维码,支持 Logo 和颜色配置
/api/qrcode节假日查询 API
查询中国法定节假日、调休安排、工作日信息
/api/holiday套餐对比
免费版
适合个人学习和测试
¥0/月- ✓ 1000 次/天
- ✓ 1 次/秒
- ✓ 突发容量 10 次
- ✓ 3 个 API
- ✓ 数据保留 7 天
- ✓ 社区支持
- × SLA 保证
- × 自定义域名
基础版
适合小型项目和初创团队
¥99/月- ✓ 10000 次/天
- ✓ 10 次/秒
- ✓ 突发容量 100 次
- ✓ 10 个 API
- ✓ 数据保留 30 天
- ✓ 邮件支持
- ✓ 99.5% SLA
- × 自定义域名
专业版
适合成长期企业和高并发场景
¥499/月- ✓ 100000 次/天
- ✓ 100 次/秒
- ✓ 突发容量 1000 次
- ✓ 所有 API
- ✓ 数据保留 90 天
- ✓ 邮件 + IM 支持
- ✓ 99.9% SLA
- ✓ 自定义域名
企业版
适合大型企业和定制需求
定制- ✓ 无限制调用
- ✓ 1000 次/秒
- ✓ 突发容量 10000 次
- ✓ 所有 API
- ✓ 永久数据保留
- ✓ 专属客户经理
- ✓ 99.95% SLA
- ✓ 定制服务
套餐如果不能落到限流上,就只是写在页面上的一个数字。这一节要说明同一份套餐额度,如何变成限流中间件里可以直接使用的参数。
根据套餐设置限流
限流参数必须从套餐配置推导出来,而不是写死在代码里。这样运营调整套餐价格或额度时,限流行为跟着一起变,不需要改代码发版。
根据套餐设置限流
- 步骤 1:读取用户当前套餐,把套餐里的每日、每秒和突发额度换算成限流参数
- 步骤 2:以用户 ID 加接口维度作为限流 key,在 Redis 中原子自增计数并设置窗口过期时间
- 步骤 3:超过额度时按策略返回排队等待或直接拒绝,并带上可重试的时间
- 步骤 4:升级后清掉旧的限流计数,降级后立即按新额度拦截,避免额度残留
关注点:套餐额度到限流参数的换算、计数 key 的维度与套餐变更后的计数清理。
用户请求
GET https://dashboard.kuaiyizhi.cn/api/v3/weather?city=北京Nginx 负载均衡
Nginx
Public API Gateway
Admin API
Admin Dashboard
MySQL
Redis 缓存 + 限流
MySQL 计费库
消息队列
外部天气 API
发现内容有问题?
告诉我们哪里需要改进。
