无论通过哪种方式发布——网页向导、导入功能,还是 AI 代理使用的 Listings API——Zyla API Hub 上的每个 API 都要经过同样的质量规则。这些规则的目的,是让客户能放心购买,也让优质的 API 更容易被发现。不满足这些规则的 API 上架页不会被发布,错误信息会说明需要修改的地方。
用英文撰写,我们帮你翻译
请用英文撰写你的 API 上架页:名称、描述、端点和 FAQ。Zyla API Hub 会自动把它翻译成 Hub 上的其他语言(西班牙语、葡萄牙语、印地语和中文),让你的 API 触达所有这些语言的客户。你修改英文内容时,对应的翻译也会一起更新。
名称
- 一个清晰的英文名称,能说明这个 API 是做什么的,并包含单词 “API”,例如 “Weather Forecast API”。
- 在 Hub 上唯一,最多 50 个字符。
- 名称要像一个成品的名字。带有测试、演示、副本、占位或与其他 API 重复含义的名称都不被接受。
- 品牌和平台名称要写全称(比如 Instagram,不要写成 IG),也不要使用其他 API 市场的名称。
描述
- 使用英文撰写,说明这个 API 是做什么的,以及它会返回什么。简短描述至少需要 50 个字符。
- 与名称和端点保持一致。
- 以信息为主,不做推广:不包含广告、价格、折扣,或无法证实的说法。
所有流程都在 Hub 上完成
Zyla API Hub 是你和客户之间的中介:发现、计费、密钥、限制和支持都在 Hub 上完成。这也是我们向双方保证质量的方式。
- 不要在 API 上架页的任何地方——名称、描述、端点、FAQ 或示例响应——包含邮箱地址、网站、电话号码、社交账号或任何其他联系方式。
- 不要邀请客户在 Hub 之外联系你或购买。
- 客户的问题会通过 Zyla 转达给你。
端点
- 一个清晰的名称,以及说明该端点功能的描述。
- 合法的方法和 base URL,每个参数都要有类型和简短描述。
- 一个真实的示例响应,让客户在购买前就能看到会得到什么。
套餐
- 至少三个付费月度套餐,且更贵的套餐必须始终包含更多调用次数。
- 每分钟速率限制在 60 到 240 次请求之间。
你可以创建多少个新 API
为了保持目录的实用性,避免大量低质量的 API 上架页涌入,每个账户都有新建 API 的配额。配额会随着你的履约记录增长。
| 账户 | 新 API | 关联 API(你某个 API 的变体) |
|---|---|---|
| 尚无付费销售 | 每 24 小时 5 个,每 7 天 20 个 | 每 24 小时 20 个 |
| 至少有一笔付费订阅 | 每 24 小时 20 个 | 每 24 小时 60 个 |
- 时间窗口是滚动的,已删除的 API 仍计入配额。编辑你现有的 API 永远不计入配额。
- 超出配额时,新 API 会被拒绝,并提示你何时可以再创建新的(Listings API 会返回
429)。你的账户和现有 API 不会受到影响。
需要更高的限额来运营一个大型、合规的目录?请联系我们的团队。
审核
保存时会运行自动检查,Zyla 团队也会对 Hub 上的 API 进行人工审核。不符合这些规则或 服务条款 的 API,即使已经发布,也可能被拒绝、隐藏或移除。