开发者体验验收：首次成功时间、留存口径与复算表
一个月 200 人注册，只有 84 人成功发出第一个请求，第二周还在调用的只剩 31 人。本文用漏斗与 cohort 拆 TTFHW、首次调用成功率、28 天调用留存与每千次调用工单数，给出分子分母、埋点事件、复盘表与可复算的验收算式。
tag
对外API
共 11 篇文章。
开发者支持：工单分级、状态页与事故沟通
七个客户用七封邮件问同一个 429 是什么意思，两周后又来五个。本文用教学案例拆开发者工单的五类与 P0–P3 时限、状态页组件与订阅、事故公告五要素与更新节奏，并给出首次响应达标率、每千次调用工单数与重复问题占比三个复算式。
版本与弃用：兼容窗口、弃用公告与迁移指南
一次把时间戳从秒改成毫秒、删掉一个「没人用」的字段，就让三个客户同一天报错。兼容性由调用方的解析方式定义，不由作者定义。本文给出兼容窗口、弃用公告、Sunset 头与三条下线判据，把破坏性变更变成客户可以排期、可以验证的迁移。
文档站：五分钟跑通第一个请求与错误自查
文档的验收指标不是页数，而是开发者从注册到看见第一个 2xx 用了多久。把 quickstart 压进五步、端点页固定六块、错误码做成双向索引，再用 TTFHW 的中位数与 P90 按月复算，并写进发布检查表，第一次成功才不靠运气。
SDK 与示例：薄封装边界、版本策略与多语言维护成本
从手写两套 SDK 拖了三个月的教学案例讲起，给出要不要做 SDK 的三个可观测判据、生成与手写的分工边界、版本对应与弃用节奏，以及按语言复算年维护成本、采用率和接入步骤差的验收方法，并说明示例仓库的跑通标准与低成本替代方案。
对外 Webhook：事件签名、重试、幂等与死信队列
从一次付款成功事件漏投的教学案例讲起，拆解对外 Webhook 的事件信封与版本、HMAC 签名与时间戳防重放、带抖动的重试窗口与幂等键、死信队列与订阅方自助排障，并给出可复算的有效投递率和重复投递率验收口径，以及本地接收器的复现步骤。
配额与限流：免费层、突发额度与超额计费
免费层开大了会破产，开小了没人愿意试。本文给出按请求、按 token 与按任务三种计量口径的取舍，免费层覆盖率怎么算，令牌桶与突发额度如何设置，429 响应头、软硬上限、超额计费的可解释性与异常用量识别，附 8 条验收清单与复算示例。
API key 管理：签发、最小权限、轮换与泄露响应
一次复制粘贴就能让 API key 出现在公开仓库里。本文给出签发与环境隔离、按端点最小权限、审计字段的设计、轮换重叠期，以及泄露后 0–24 小时的处置顺序与负责人分工，并附影响面复算口径、8 条验收清单和一次可执行的桌面演练方法。
API 规范：OpenAPI 契约、统一错误模型与分页约定
三个端点把同一个错误返回成三种形状，客户只好写三套解析。用 OpenAPI 当单一事实源，固定字段与时间格式，统一错误信封与状态码语义，再定游标分页、过滤白名单与幂等键保留期，最后用契约覆盖率与错误码重复率两个数字验收，且都要能复算。
要不要做 API：三类买家、收入结构与退出条件
三个客户都问有没有接口，真正付费的只有一个。把 API 当独立产品线来算：三类买家的稳定性要求、三种收入结构的对账成本、五项固定开支与四条退出条件，并复算每千次调用成本与保本量。先证明有人为可编程访问单独付钱，再写第一个端点。
一个人把 API 做成产品：对外接口、开发者体验与支持（10 篇）
10 篇讲一个人怎么把能力做成对外 API：先判断要不要做与收入结构，再定 OpenAPI 契约与统一错误模型；然后是 key、配额、Webhook、SDK、文档站、版本弃用与开发者支持，最后用首次成功时间和调用留存验收。