REST API、认证与配额

公共 base URL 为 https://public-api.atlasrepo.com。查看 Swagger 或 OpenAPI JSON。公共规范只包含客户端操作，不含 Admin、internal automation、operator 和私有 Scout operations。

公共操作声明 security: []。符合条件的 API 操作通过 x-api-key 请求头接收密钥；账户接口使用已认证的网站会话。不要把密钥放在浏览器代码、URL、日志或代码库中。

export ATLASREPO_API_KEY='replace-with-your-key'
curl --fail-with-body -H "x-api-key: $ATLASREPO_API_KEY" \
  'https://public-api.atlasrepo.com/api/catalog/search?q=workflow&limit=10'

常用公共方法包括 GET /api/catalog/top、GET /api/pulse、GET /api/courses、GET /api/courses/{slug}、GET /api/skills。GET /api/catalog/search 需要符合条件的密钥或付费会话。参数和响应以 Swagger 为准。

GET /api/account/mcp-oauth 返回当前用户的 connections，以及包含 tier、plan、unit: "requests"、limit、used、remaining、windowSeconds、resetAt、unlimited 的 quota。它描述请求时间窗，不一定是月度限额。无限配额的 limit、remaining、resetAt 为 null；有限但未激活的时间窗为 used: 0、remaining: limit、resetAt: null。OAuth scopes 与 expiry 含义不变。