面向 API 开发者

API 分发:从公开示例到各大 API 市场

开发者会选择几分钟就能试用的 API。这让 API 的分发与其他产品都不一样:真正替你销售的是公开示例和文档,所有市场、网络和列表都建立在它们之上。这份计划把渠道按顺序排好,引用各渠道的真实要求,并用这些要求检查你的 OpenAPI 文件。

简短回答

  1. 让第一次成功调用变得轻而易举:一个基础 URL,一步拿到密钥,一个可直接复制的请求,旁边放上真实的响应。
  2. 只维护一个 OpenAPI 文件,作为唯一的数据源。Postman 和 RapidAPI 都建议导入它,APIs.guru 则需要它的一个稳定 URL。
  3. 然后上架到开发者已经在搜索的地方:Postman API Network;想要内置计费就选 RapidAPI Hub;有免费额度就上 public-apis;定义本身交给 APIs.guru。
  4. 等它不用销售沟通也能用起来,再发布:Show HN 和 Product Hunt;如果希望 AI 应用把你的 API 当作工具调用,再做一个 MCP 服务器。

渠道的先后顺序

每一步都复用上一步的成果。跳过前两步,后面的每一次上架都会变弱。

渠道你能得到什么需要什么费用
1 你自己的文档和公开示例所有其他渠道都会链接到的页面,也是开发者做决定的地方。基础 URL、一步完成的认证、可复制的请求、对应的响应、看得懂的错误信息。你的时间
2 Postman API Network在 Postman 内和自然搜索中被发现;开发者可以 fork 的集合。一个公开工作区,包含从 OpenAPI 导入的参考集合和一个概览集合。发布者文档中未提及费用
3 RapidAPI Hub它的用户群、针对搜索优化的资料页、密钥管理和计费。一个 API 项目(导入 OpenAPI)、公开可见、定价方案、用于收款的 PayPal。上架免费;抽取 25% 的付款
4 public-apis在 GitHub 上有 485k 星的精选列表中占一行。免费访问或免费额度、HTTPS、Auth 和 CORS 信息、不超过 100 个字符的描述。免费;营销性质的拉取请求会被拒绝
5 APIs.guru你的定义出现在一个公开的 API 定义目录中。指向机器可读定义(例如 OpenAPI)的稳定 URL。表单上未提及费用
6 为你的 API 做一个 MCP 服务器AI 应用可以把你的 API 当作工具调用。一个封装你 API 的服务器,并收录到 MCP 注册表中。主要注册表免费
7 Product Hunt在早期用户面前亮相的一个发布日。一个能用的公开示例,以及非开发者也能看懂的页面。免费
8 Show HN会亲手试用并直言感受的开发者。马上就能试的东西、朴素的标题、在评论区回复的你。免费

渠道名称链接到官方页面或我们对该平台的介绍页。我们有意不在这里列出其他市场。

从公开示例开始

Postman 用一句话概括了这一点:成功始于用最少的步骤拿到第一个 200 OK。在做任何上架之前先写好示例,因为每一次上架都会把人引到这里。

  1. 一个基础 URL放在文档最上方和 OpenAPI 文件的 servers 列表里,始终使用 HTTPS。
  2. 一步拿到密钥从注册到拿到密钥,不需要销售沟通。一个测试密钥或带少量配额的免费方案就够了。
  3. 可直接复制的请求一条包含所有请求头的完整命令。开发者会先粘贴它,然后才读别的内容。
  4. 真实的响应展示实际返回的 JSON,包括用户接下来需要的字段。
  5. 会解释的错误为 4xx 响应写好文档:缺少密钥、参数错误、配额用尽,每种都附上对应信息。
curl "https://api.example.com/v1/forecast?city=Berlin" \
  -H "X-API-Key: $API_KEY"

HTTP/1.1 200 OK
{ "city": "Berlin",
  "days": [{ "date": "2026-10-01", "temp_c": 14.2 }] }

HTTP/1.1 401 Unauthorized
{ "error": "missing_api_key",
  "message": "Send your key in the X-API-Key header." }
一个示例请求和响应,展示你的文档应有的样子(example.com 只是占位符)。

检查你的 OpenAPI 文件

粘贴你的 openapi.json。检查会读取上架渠道从中提取的内容(标题、版本、servers、操作、示例、认证),并显示哪些渠道已就绪。你会得到一份 Markdown 计划;如果符合条件,还会得到一行 public-apis 格式的条目。检查在你的浏览器中运行,不会上传任何内容。

文件内容: –

检查项

  • OpenAPI 3.x 文档
  • 已设置 info.title
  • 已设置 info.version
  • 至少 40 个字符的描述
  • 不超过 100 个字符的一句话描述
  • 公开的 HTTPS 服务器 URL
  • 至少一个操作
  • 每个操作都有 summary 或 description
  • operationId 值唯一
  • 请求或响应示例
  • 每个操作都有错误响应(4xx、5xx 或 default)
  • 已读取上架所需的认证类型
  • 联系方式或文档链接
  • 服务条款链接

已就绪

  • Postman API Network
  • RapidAPI Hub
  • public-apis
  • APIs.guru

public-apis 格式的条目

–

检查不会抓取 URL、调用你的 API 或提交任何内容,只读取你粘贴的文本。

为什么 OpenAPI 文件很重要

规则官方原文对你意味着什么
标题The title of the API.info.title 是必填项,它会成为每个上架页面上的名称。
operationIdThe id MUST be unique among all operations described in the API.重复的 ID 会让导入和生成的代码出错;保持每一个都唯一。
先导入If you have one, we strongly suggest you start by importing your file.用你的 OpenAPI 文件创建 RapidAPI 项目,而不是手动填写。
参考集合Postman recommends you import your OpenAPI definition to create your API reference collection.导入 OpenAPI 文件,不要手动重建请求。
定义The most important requirement is the presence of a machine-readable API definition in one of the popular formats, such as: OpenAPI (formerly known as Swagger), RAML, API Blueprint, etc.没有机器可读的定义,就不能收录。
稳定 URLSo please, provide us with a stable URL to the definition.用一个不随版本变化的 URL 提供定义。

通过 RapidAPI 销售

人们问怎么卖 API 时,多数指的就是 RapidAPI 这个市场。上架免费,你按收入支付一定比例。新 API 默认是私有的,所以在你把项目设为公开之前,它不会出现在 Hub 中。

一个 US$100 的方案,按 25% 的费率你会拿到 US$75,通过 PayPal 支付。免费方案的上限是每小时 1,000 次请求、每月 500,000 次。

  1. 创建项目时导入你的 OpenAPI 文件,它会自动填好端点和参数。
  2. 写一段简短描述和一段详细描述,设置类别、网站和基础 URL,并上传 logo。
  3. 提供一个小额度的免费方案让开发者测试,再提供配额和超额费用清晰的付费方案。
  4. 在第一次收款前绑定 PayPal;Rapid 不通过其他任何方式向提供者付款。
  5. 保留你自己的文档和定价页:市场只是一个渠道,不是你唯一的店面。
规则官方原文对你意味着什么
上架费用It is also free and easy to add your API to the hub.把 API 添加到 RapidAPI 不花钱。
你能得到什么Adding your API to the rapidapi.com hub gets you instant exposure to our growing user base, a search engine-optimized profile page for your API, as well as features like user management and billing services.上架后自带资料页、密钥管理和计费。
默认私有When a user or team creates an API, by default it is a private API.把可见性切换为公开,否则没人能找到这个 API。
免费方案Having a free pricing plan (with a small number of requests available) is vital to a good experience for a developer using your API.一点免费额度能让开发者在付费前先测试。
免费上限Free API plans are limited to 1000 requests per hour and 500K requests per month.用量更大时需要付费方案或按量计费方案。
市场佣金Rapid takes a flat 25% marketplace fee on all payments made through the API Hub.给方案定价时要把 25% 的分成算进去。
收款Rapid currently only pays out API providers via PayPal.在赚到第一笔钱之前绑定 PayPal 账户。

Postman、public-apis 和 APIs.guru

这三个渠道都不花钱,并且能在开发者寻找 API 的那一刻触达他们。每个都有自己的规则;遵守规则,上架就能保留。

规则官方原文对你意味着什么
第一次调用This starts with getting your API consumers to their first 200 OK response in the fewest steps possible.用陌生人多快能拿到 200 OK 来衡量你的文档。
曝光Sharing APIs on the Postman API Network increases your API’s discovery in organic and Postman search results.公开工作区会出现在 Postman 搜索和网页搜索结果中。
密钥安全If Postman detects any API keys, tokens, or similar, it replaces them with placeholders.即便如此,公开集合中的密钥也要用变量。
认证发布者Verify your team’s identity by verifying you own your domain.要拿到徽章,需要一个你能控制的域名。
免费访问Please make sure the API you want to add has full, free access or at least a free tier and does not depend on the purchase of a device/service before submitting.只收费的 API 不属于这个列表。
禁止营销Pull requests that are identified as marketing attempts will not be accepted.描述 API 做什么,而不是它为什么最好。
描述The Description should not exceed 100 characters.这一行控制在 100 个字符以内。

发布你的 API

等示例和至少一个上架渠道上线后再发布效果最好,这样每位访客当天就能发起调用。

Show HN
在别人不用找你沟通就能试用 API 时再发帖。朴素的标题、第一条评论里的示例和及时的回复,比发帖时间更重要。 如何在 Show HN 上发布你的产品 →
Product Hunt
展示 API 能实现什么,而不只是端点:一个简短演示、一个免费方案,以及非开发者也能看懂的页面。
MCP 服务器
如果希望 AI 应用使用你的 API,就用 MCP 服务器封装它,并发布到 MCP 注册表。它是一个独立的产品,有自己的上架渠道。 MCP 服务器目录:上架你的服务器的 10 个地方 →
你的更新日志
每个新端点或 SDK 都是再次发帖的理由。维护一份公开的更新日志,并从文档链接过去。

LaunchRepo 的作用

LaunchRepo 在你的编程智能体中运行。智能体会把你产品的网站提交到一个由目录站和发布平台组成的大型目录中,并维护一个区分已上线和待审核条目的追踪表。

市场账号、定价方案、收款和 MCP 服务器都由你自己掌控,因为它们需要你的密钥和决定。LaunchRepo 不会把 API 提交到 RapidAPI、Postman 或 GitHub 列表;它负责为你的 API 网站填写通用目录站的提交表单。

来源

每条规则和每个数字都于 2026年10月1日 在发布方自己的页面上核对过,并以英文原文逐字引用。文本副本与我们的证据一并保存。

来源最后更新核对日期
OpenAPI Specification v3.1.1
RapidAPI docs: What is rapidapi.com?未注明日期
RapidAPI docs: Adding APIs - Getting Started未注明日期
RapidAPI docs: Hub Listing - Overview未注明日期
RapidAPI docs: Hub Listing - General Tab未注明日期
RapidAPI docs: Monetizing Your API on rapidapi.com未注明日期
RapidAPI docs: Payouts and Finance未注明日期
Postman Docs: Postman API Network overview未注明日期
Postman Docs: Showcase your public APIs on the Postman API Network未注明日期
Postman Docs: Become a verified publisher on the Postman API Network未注明日期
Postman Docs: Prepare your public collections未注明日期
public-apis/public-apis: CONTRIBUTING.md未注明日期
public-apis/public-apis未注明日期
APIs.guru: Add API未注明日期

常见问题

怎样推广一个 API?
先做一个公开示例,让陌生人几分钟内完成第一次成功调用,然后把 API 上架到开发者搜索的地方:Postman API Network;想要内置计费就用 RapidAPI;免费 API 上 public-apis;定义交给 APIs.guru。等它不需要你帮忙也能用起来,再到 Show HN 和 Product Hunt 发布。
怎样在 RapidAPI 上销售 API?
在 RapidAPI Studio 中创建 API 项目,导入你的 OpenAPI 文件,填写 Hub 上架信息,添加定价方案,把 API 设为公开,并绑定 PayPal 用于收款。上架免费;在核对当天,Rapid 对付款统一收取 25% 的市场佣金。
我需要 OpenAPI 文件吗?
不是每个渠道都必须,但它最省事。RapidAPI 和 Postman 都建议导入它,APIs.guru 只收录机器可读的定义。把一个文件作为文档和上架信息的唯一数据源。
付费 API 能进 public-apis 列表吗?
只有在它提供完全免费访问或至少有免费额度,并且不需要购买设备或服务时才可以。维护者会拒绝看起来像营销的拉取请求。
我的 API 也应该做成 MCP 服务器吗?
如果希望 AI 应用把它当作工具调用,是的,做成一个封装 API 的独立服务器。它收录在 MCP 注册表中,而不是 API 市场里。
LaunchRepo 会把我的 API 上架到 RapidAPI 或 Postman 吗?
不会。这些上架需要你的账号、密钥、定价和收款信息。LaunchRepo 通过你的编程智能体,把产品网站提交到通用目录站和发布平台。

目录站交给你的智能体

一次购买,你的编程智能体,你做的每个产品:在你打磨文档的同时,LaunchRepo 把你的 API 网站提交到目录站和发布平台。

查看价格