Developer

微型 SaaS API 市场

一个下午就能上架、计量并变现你的 API。

微型 SaaS API 市场 is api 变现 for teams that want the reasoning shown, not hidden. Plans start at $29 a month with a 14-day free trial.

开始免费试用

把接口发布出去是容易的那一半。难的那一半在周边：密钥管理、用量计量、限流、按量计费，以及一份不会过时的文档。API 市场工具包提供这一层，让您不必为了卖一个一年前就做好的接口，先花三个月搭基础设施。

密钥、配额与限流

每个调用方获得各自授权范围的密钥，并且可以不中断地轮换：新密钥可以与旧密钥同时有效，直到切换完成。这看起来理所当然，而自建方案里缺的往往正是它。

限流以按密钥、按端点的令牌桶方式运行，在持续速率之上留出突发余量。关键在响应头：剩余配额、重置时刻，以及 429 时的 `Retry-After`。没有这些响应头，调用方无法表现得体，于是它们会带着无限重试回来。

按密钥的授权范围: 权限按密钥而不是按账户划分，让一个泄露的密钥造成的损害有限。
令牌桶限流: 持续速率加突发余量，按密钥、按端点，并配齐配额响应头。
用量计量: 逐次调用计数，记录是幂等的，重试不会被重复计费。
活的文档: 由 OpenAPI 定义生成，并带可以对沙箱实际执行的示例。

算得对的按量计费

按量计费的难处出现在计量与计费不一致的地方。超时之后重发的调用不该被算两次。您这一侧的服务端错误完全不该被计。而客户看到的计数器，必须与账单上的那个是同一个。

这里的计量按调用标识符做到幂等，排除 5xx 响应，并且只更新一个计数器——客户门户和计费流程读的都是它。阶梯价格、免费额度和最低消费，全部在这个唯一的计数器上计算。

版本管理与下线预告

活得够久的接口都会有第二个版本，而这次过渡正是提供方失去调用方的地方。这里版本体现在路径上，可以并行运行，下线计划会在进入邮件之前先出现在响应头里。

随之而来的是按版本的用量：您能看到哪些调用方还在旧版本上、量有多大，于是关停的决定可以建立在数字上。一个被三个客户每天调十次的端点，和一个承载一半流量的端点，是两回事。

限流与计量如何配合

限流和计费读的是同一批事件，但做的是不同的决定。顺序很重要，这里是固定的。

校验密钥与授权范围认证和授权先于一切；被拒绝的调用不消耗配额，也不计费。
查询配额检查该密钥的令牌桶。不足时返回带 Retry-After 的 429，调用不会到达您的业务逻辑。
执行请求调用进入您的服务；执行时长和状态码被记录下来。
只在成功时计为可计费5xx 响应会被记录但不计费——您这一侧的故障不是已提供的服务。
幂等地记录计数按调用标识符进行，使用同一标识符的重试不会再次推动计数器。

第四步常被忽略，而它损害信任的速度比任何价格都快。一个为以您的服务端错误收尾的调用付过钱的客户，下一次会逐行核对账单——而那时他会把其余问题也一并找出来。

适合谁

要开放接口的 SaaS

从"我们有内部接口"到"客户可以为它付费"的最快路径，不必自己从头搭计费层。

数据提供方

带阶梯和免费额度的按量计费本身就是产品，而一个可信的计数器是它的前提。

内部平台团队

同一层去掉计费，但保留按团队的配额——当某个内部服务被邻组无意压垮时很有用。

有第二个接口版本的团队

按版本的用量和可见的下线预告响应头，把一次有风险的关停变成一项有计划的操作。