跳到主要内容

开发者

公开 API

以程序化方式管理工具收录。写接口按 IP 限制为每分钟 60 次。

面向 AI agent 的只读 API

公开、匿名、只读。这些接口以稳定的 JSON 返回站内已发布的工具,按 IP 限流 120 次 / 60 秒。

无需 API key 或 Bearer 令牌:请勿在此处传发布密钥。

  • GET https://www.getsitools.com/api/public/tools分页、排序,并可按分类或标签筛选已发布工具。
  • GET https://www.getsitools.com/api/public/tools/{slug}按 slug 获取单个工具,含截图、产品支持语言与语种覆盖情况。
  • GET https://www.getsitools.com/api/public/categories某个语种下的分类树,附已发布工具数。

示例

curl 'https://www.getsitools.com/api/public/tools?q=image%20editing&pageSize=5&locale=en' \
  -H 'Accept: application/json'
  • openapi.json — OpenAPI 3.1 描述
  • llms.txt — llms.txt —— 给 AI agent 的站点摘要
  • llms-full.txt — llms-full.txt —— 全部已发布工具及一句话简介

鉴权

仅写接口需要鉴权。只读 API 公开无需密钥。

Authorization: Bearer <PUBLISH_API_KEY>

在服务端配置 PUBLISH_API_KEY。未配置时,API 会返回 503,而不会接受未鉴权的写入。

限流规则

限流按 IP 和路由作用域独立计算。读接口与写接口使用不同的令牌桶,因此大量读取不会耗尽写入额度。

读接口: 120 / 60s
写接口: 60 / 60s

所有响应都会返回 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset。触发 429 时还会返回 Retry-After。

接口列表

以下示例使用 PUBLISH_API_KEY。请将工具 ID 占位符替换为提交接口返回的工具 ID。

POST/api/v1/tools/submit-url

提交网址

只需提交一个网址,采集端会自动抓取网站元数据、翻译并发布。整个过程免费审核,无需人工干预。

仅支持核心 AI 工具的 HTTP/HTTPS 网址,aiOnlyConfirmed 必须为 true。返回 queued 表示网址已成功进入采集队列。

请求

curl -X POST 'https://www.getsitools.com/en/api/v1/tools/submit-url' \
  -H 'Authorization: Bearer $PUBLISH_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com",
    "aiOnlyConfirmed": true
  }'

响应

{
  "id": "submission_abc123",
  "submissionId": "submission_abc123",
  "status": "queued",
  "duplicate": false,
  "message": "URL submitted successfully. The collector will scrape and process it automatically."
}

错误响应

错误以 JSON 返回,包含稳定的错误码和可读的错误信息。

状态码错误码含义
400VALIDATION_ERROR请求体或查询参数不合法。
401UNAUTHORIZEDBearer Token 缺失或不正确。
404NOT_FOUND请求的工具不存在。
422LOCALES_INCOMPLETE必填语言字段缺失,工具暂时无法发布。
429RATE_LIMITED请求超过限流阈值,请在 Retry-After 指定的时间(约 60 秒)后重试。
503API_KEY_NOT_CONFIGURED服务端未配置 PUBLISH_API_KEY,写入接口已禁用。