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