# 质量规则与限制

无论通过哪种方式发布——网页向导、导入功能，还是 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 进行人工审核。不符合这些规则或 [服务条款](https://zylalabs.com/zh/terms) 的 API，即使已经发布，也可能被拒绝、隐藏或移除。


---
Source: https://zylalabs.com/zh/docs/quality-rules