{"openapi":"3.1.0","info":{"title":"oh! IT","version":"2.3.0+git.abb6c0694081","description":"HTTP 工具 API。命令行表示适用于带 curl 或 curl* 标记的接口。协商顺序为 _format、Accept、默认格式。Accept 支持 application/json、text/plain 和 image/svg+xml，按 q 值从高到低选择，相同值按出现顺序选择。curl* 接口默认 SVG；curl 接口在 curl、wget 或 HTTPie 中默认 text，其他客户端默认 JSON。_format 接受 json、text，plain 是 text 的别名；curl* 接口和 /color/{hex} 还支持 svg，/color/{hex} 的默认格式保持 JSON。其他接口收到 _format=svg 或 Accept: image/svg+xml 时返回 JSON。未识别的 _format 值继续按 Accept 协商。text 默认带 ANSI 颜色，_color=0、false、off、no 关闭颜色，其他值保持颜色。GET /badge 的 color 用于徽章颜色，_color 独立控制 ANSI。这些响应带 Vary: Accept。 倒计时公开缓存 60 秒，其余由输入决定的图形缓存 1 天。接口访问类别和 Bearer 认证要求见各操作说明。短链接与 Pastebin 的创建和管理要求 Token，分享地址允许匿名访问。业务接口支持跨域无凭据调用，并可提供 Authorization Token。匿名请求按 IP 使用每分钟约 120 次普通额度、30 次网络额度和 10 次计算额度；Token 请求按身份使用 D1 原子计数，普通额度独立配置，资源额度分别为 30 和 10。认证查询另有来源保护。鉴权及普通额度检查先于缓存，缓存未命中时检查资源额度。Minecraft 玩家与图片缓存 300 秒、服务端状态缓存 30 秒、种子结果缓存 3600 秒；RDAP 成功结果缓存 300 秒，引导文件缓存 24 小时；Bing 缓存最长 300 秒并受快照有效期约束。受限接口、分享内容、错误和敏感输入响应使用 no-store。POST /pastes 请求体最多 512 KiB，文本最多 65536 个 UTF-8 字节；其他接口请求体最多 65536 字节。限流返回 429、RATE_LIMITED 和 Retry-After。响应 X-Request-Id 可关联 Worker 日志。OPTIONS、静态资源和匿名连通性探测保留原有用途。","license":{"name":"MIT","url":"https://opensource.org/license/mit"}},"paths":{"/api.json":{"get":{"tags":["项目信息"],"summary":"列出可用接口","responses":{"200":{"description":"项目及接口目录","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"build":{"type":"object","properties":{"version":{"type":"string","description":"基础版本加 Git 构建元数据，符合 SemVer"},"gitHash":{"type":"string","pattern":"^(?:[0-9a-f]{40}|[0-9a-f]{64})$"},"buildTime":{"type":"string","format":"date-time","description":"构建开始时间，UTC ISO 8601"}},"required":["version","gitHash","buildTime"]},"openapi":{"type":"string"},"docs":{"type":"string"},"endpoints":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"access":{"type":"string","enum":["anonymous","token","admin"]}},"required":["method","path","description","category","access"]}}},"required":["name","version","build","openapi","docs","endpoints"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/version.json":{"get":{"tags":["项目信息"],"summary":"获取构建版本信息","responses":{"200":{"description":"当前构建的版本、Git hash 和构建时间","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","description":"基础版本加 Git 构建元数据，符合 SemVer"},"gitHash":{"type":"string","pattern":"^(?:[0-9a-f]{40}|[0-9a-f]{64})$"},"buildTime":{"type":"string","format":"date-time","description":"构建开始时间，UTC ISO 8601"}},"required":["version","gitHash","buildTime"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/healthz":{"get":{"tags":["项目信息"],"summary":"健康检查","responses":{"200":{"description":"Worker 能够处理请求","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]}},"required":["status"],"example":{"status":"ok"}}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/base64/encode":{"post":{"summary":"将 UTF-8 文本编码为标准 Base64","tags":["编码转换"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8192,"example":"你好 🌍"}},"required":["text"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"转换后的文本","example":"hello"}},"required":["text"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/base64/decode":{"post":{"summary":"将规范 Base64 解码为 UTF-8 文本","tags":["编码转换"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":16384,"example":"aGVsbG8="}},"required":["text"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"转换后的文本","example":"hello"}},"required":["text"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/url/encode":{"post":{"summary":"URL 组件编码，空格使用 %20","tags":["编码转换"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8192,"example":"你好 🌍"}},"required":["text"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"转换后的文本","example":"hello"}},"required":["text"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/url/decode":{"post":{"summary":"URL 组件解码，保留字面加号","tags":["编码转换"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8192,"example":"你好 🌍"}},"required":["text"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"转换后的文本","example":"hello"}},"required":["text"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/hash":{"post":{"summary":"计算八种小写十六进制摘要","tags":["摘要计算"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8192,"example":"你好 🌍"}},"required":["text"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"md5":{"type":"string","minLength":32,"maxLength":32,"pattern":"^[0-9a-f]+$","description":"32 位小写十六进制摘要"},"sha1":{"type":"string","minLength":40,"maxLength":40,"pattern":"^[0-9a-f]+$","description":"40 位小写十六进制摘要"},"sha256":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]+$","description":"64 位小写十六进制摘要"},"sha384":{"type":"string","minLength":96,"maxLength":96,"pattern":"^[0-9a-f]+$","description":"96 位小写十六进制摘要"},"sha512":{"type":"string","minLength":128,"maxLength":128,"pattern":"^[0-9a-f]+$","description":"128 位小写十六进制摘要"},"sha3_256":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]+$","description":"64 位小写十六进制摘要"},"sha3_512":{"type":"string","minLength":128,"maxLength":128,"pattern":"^[0-9a-f]+$","description":"128 位小写十六进制摘要"},"crc32":{"type":"string","minLength":8,"maxLength":8,"pattern":"^[0-9a-f]+$","description":"8 位小写十六进制摘要"}},"required":["md5","sha1","sha256","sha384","sha512","sha3_256","sha3_512","crc32"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/hmac":{"post":{"summary":"计算五种 HMAC，密钥通过 JSON 请求体传入","tags":["摘要计算"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":8192,"example":"你好 🌍"},"key":{"type":"string","maxLength":8192,"example":"你好 🌍"}},"required":["text","key"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"md5":{"type":"string","minLength":32,"maxLength":32,"pattern":"^[0-9a-f]+$","description":"32 位小写十六进制摘要"},"sha1":{"type":"string","minLength":40,"maxLength":40,"pattern":"^[0-9a-f]+$","description":"40 位小写十六进制摘要"},"sha256":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]+$","description":"64 位小写十六进制摘要"},"sha384":{"type":"string","minLength":96,"maxLength":96,"pattern":"^[0-9a-f]+$","description":"96 位小写十六进制摘要"},"sha512":{"type":"string","minLength":128,"maxLength":128,"pattern":"^[0-9a-f]+$","description":"128 位小写十六进制摘要"}},"required":["md5","sha1","sha256","sha384","sha512"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/pbkdf2":{"post":{"summary":"使用 PBKDF2 派生十六进制密钥","tags":["摘要计算"],"description":"使用 crypto.subtle，不回显密码或盐。迭代上限 100000，并占用计算类限流额度。\n访问类别：匿名 API，可携带 Token 使用独立额度","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string","maxLength":1024,"example":"password"},"salt":{"type":"string","minLength":1,"maxLength":256,"example":"salt"},"iterations":{"type":"integer","minimum":1,"maximum":100000,"default":1000,"example":1,"description":"1–100000，默认 1000"},"hash":{"type":"string","enum":["SHA-1","SHA-256","SHA-384","SHA-512"],"default":"SHA-256","example":"SHA-1"},"bits":{"type":"integer","minimum":8,"maximum":512,"default":256,"example":160,"description":"派生位数，8 的倍数，最大 512"}},"required":["password","salt"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^[0-9a-f]+$"},"iterations":{"type":"integer"},"bits":{"type":"integer"},"algorithm":{"type":"string","enum":["SHA-1","SHA-256","SHA-384","SHA-512"]}},"required":["hash","iterations","bits","algorithm"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]}},"/jwt/decode":{"post":{"summary":"解码 JWT，verified 固定为 false","tags":["JWT 解析"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":16384,"example":"eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyIiwiZXhwIjowfQ.c2ln"}},"required":["token"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"header":{"type":"object","additionalProperties":{}},"payload":{"type":"object","additionalProperties":{}},"verified":{"type":"boolean","enum":[false]},"times":{"type":"object","properties":{"exp":{"type":["string","null"],"description":"UTC ISO 8601 时间，支持扩展年份","example":"1970-01-01T00:00:00.000Z"},"iat":{"type":["string","null"],"description":"UTC ISO 8601 时间，支持扩展年份","example":"1970-01-01T00:00:00.000Z"},"nbf":{"type":["string","null"],"description":"UTC ISO 8601 时间，支持扩展年份","example":"1970-01-01T00:00:00.000Z"}},"required":["exp","iat","nbf"]}},"required":["header","payload","verified","times"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/uuid":{"get":{"summary":"生成密码学随机 UUID v4","tags":["随机数据"],"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"}},"required":["uuid"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/random":{"get":{"summary":"使用拒绝采样生成随机字符串","tags":["随机数据"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":1024,"default":32,"example":32},"required":false,"name":"length","in":"query"},{"schema":{"type":"string","enum":["alnum","hex","numeric","lower","upper","symbols","custom"],"default":"alnum","example":"alnum"},"required":false,"name":"charset","in":"query"},{"schema":{"type":"string","maxLength":512,"description":"custom 字符集，按 Unicode 代码点去重，最多 256 个不同字符","example":"abc🌍"},"required":false,"description":"custom 字符集，按 Unicode 代码点去重，最多 256 个不同字符","name":"chars","in":"query"}],"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"random":{"type":"string"},"length":{"type":"integer"},"charset":{"type":"string"}},"required":["random","length","charset"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/time":{"get":{"summary":"转换 Unix 秒或毫秒，默认使用当前时间","tags":["时间与计划"],"parameters":[{"schema":{"type":"string","pattern":"^[+-]?\\d+$","description":"安全整数，转换后的毫秒值绝对值不超过 8640000000000000","example":"0"},"required":false,"description":"安全整数，转换后的毫秒值绝对值不超过 8640000000000000","name":"value","in":"query"},{"schema":{"type":"string","enum":["seconds","milliseconds"],"default":"seconds","example":"seconds"},"required":false,"name":"unit","in":"query"}],"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"seconds":{"type":"integer"},"milliseconds":{"type":"integer"},"iso":{"type":"string","description":"UTC ISO 8601 时间，支持扩展年份","example":"1970-01-01T00:00:00.000Z"}},"required":["seconds","milliseconds","iso"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/cidr":{"post":{"summary":"计算 IPv4 或 IPv6 CIDR 地址范围","tags":["网络查询"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cidr":{"type":"string","minLength":1,"maxLength":128,"description":"IPv4 使用四段十进制；IPv6 不带区域标识；省略前缀时表示单个地址","example":"192.168.1.9/24"}},"required":["cidr"]}}}},"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","enum":["IPv4","IPv6"]},"address":{"type":"string"},"network":{"type":"string"},"prefix":{"type":"integer","minimum":0,"maximum":128},"mask":{"type":"string"},"first":{"type":"string"},"last":{"type":"string"},"broadcast":{"type":["string","null"]},"total":{"type":"string","pattern":"^\\d+$"},"hosts":{"type":"string","pattern":"^\\d+$"}},"required":["version","address","network","prefix","mask","first","last","broadcast","total","hosts"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/cron":{"get":{"summary":"计算五字段 Cron 在指定 IANA 时区的后续运行时间","tags":["时间与计划"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256,"example":"0 3 * * *"},"required":true,"name":"expr","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":128,"default":"UTC","example":"Asia/Shanghai"},"required":false,"name":"tz","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":3,"example":3},"required":false,"name":"n","in":"query"},{"schema":{"type":"string","format":"date-time","example":"2026-01-01T00:00:00Z"},"required":false,"name":"from","in":"query"}],"responses":{"200":{"description":"计算结果","content":{"application/json":{"schema":{"type":"object","properties":{"expr":{"type":"string"},"tz":{"type":"string"},"from":{"type":"string","format":"date-time"},"next":{"type":"array","items":{"type":"string","description":"UTC ISO 8601 时间，支持扩展年份","example":"1970-01-01T00:00:00.000Z"},"minItems":1,"maxItems":10}},"required":["expr","tz","from","next"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/countdown/{date}":{"get":{"tags":["趣味工具"],"summary":"生成可嵌入的倒计时 SVG","description":"公开缓存 60 秒。仅有日期时按 tz 的当天零点计算。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":8,"maxLength":40,"example":"2026-12-31","description":"YYYY-MM-DD，或带偏移的 ISO 时间"},"required":true,"description":"YYYY-MM-DD，或带偏移的 ISO 时间","name":"date","in":"path"},{"schema":{"type":"string","maxLength":48,"default":"","description":"可选标题"},"required":false,"description":"可选标题","name":"title","in":"query"},{"schema":{"type":"string","enum":["dark","light"],"default":"dark"},"required":false,"name":"theme","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":128,"default":"UTC","example":"Asia/Shanghai"},"required":false,"name":"tz","in":"query"},{"$ref":"#/components/parameters/FormatImage"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"倒计时图。_format=json 时返回剩余时间。","content":{"image/svg+xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"svg":{"type":"string"}},"required":["svg"],"additionalProperties":{}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"format"}},"/ascii":{"get":{"tags":["趣味工具"],"summary":"用内置字体生成 ASCII 大字","description":"small 为 5×7，standard 为两倍放大。只接受内置可打印 ASCII。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":32,"example":"Hi"},"required":true,"name":"text","in":"query"},{"schema":{"type":"string","enum":["small","standard"],"default":"small"},"required":false,"name":"font","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"font":{"type":"string","enum":["small","standard"]},"ascii":{"type":"string"}},"required":["text","font","ascii"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/emoji":{"get":{"tags":["趣味工具"],"summary":"把文字或图案转成 emoji 拼图","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":16,"example":"Hi"},"required":false,"name":"text","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":800,"description":"用 # 表示填充、. 或空格表示空白，最多 20 行、每行 40 列","example":"#.#\n.#."},"required":false,"description":"用 # 表示填充、. 或空格表示空白，最多 20 行、每行 40 列","name":"pattern","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":16,"default":"🟩"},"required":false,"name":"fill","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":16,"default":"⬜"},"required":false,"name":"blank","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["text","pattern"]},"art":{"type":"string"}},"required":["mode","art"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/identicon/{seed}":{"get":{"tags":["趣味工具"],"summary":"生成 GitHub 风格的 identicon SVG","description":"由种子的 SHA-256 决定对称图案和颜色，公开缓存 1 天。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"example":"octocat"},"required":true,"name":"seed","in":"path"},{"schema":{"type":"integer","minimum":16,"maximum":512,"default":80},"required":false,"name":"size","in":"query"},{"$ref":"#/components/parameters/FormatImage"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"5×5 对称 identicon。","content":{"image/svg+xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"svg":{"type":"string"}},"required":["svg"],"additionalProperties":{}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"format"}},"/badge":{"get":{"tags":["趣味工具"],"summary":"生成 Shields 风格的 SVG 徽章","description":"公开缓存 1 天。color 是徽章颜色，可用名称或 6 位十六进制。_color 控制纯文本响应的 ANSI 颜色。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":32,"example":"build"},"required":true,"name":"label","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":32,"example":"passing"},"required":true,"name":"message","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":32,"default":"brightgreen"},"required":false,"name":"color","in":"query"},{"schema":{"type":"string","enum":["flat","flat-square"],"default":"flat"},"required":false,"name":"style","in":"query"},{"$ref":"#/components/parameters/FormatImage"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"左右标签徽章。","content":{"image/svg+xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"svg":{"type":"string"}},"required":["svg"],"additionalProperties":{}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"format"}},"/qr":{"get":{"tags":["趣味工具"],"summary":"生成 SVG 二维码","description":"文本最多 256 个 UTF-16 代码单元，公开缓存 1 天。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256,"example":"https://oit.sh"},"required":true,"name":"text","in":"query"},{"schema":{"type":"string","enum":["L","M","Q","H"],"default":"M"},"required":false,"name":"ecc","in":"query"},{"$ref":"#/components/parameters/FormatImage"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"二维码，含两模块安静区。","content":{"image/svg+xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"svg":{"type":"string"}},"required":["svg"],"additionalProperties":{}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"format"}},"/color/{hex}":{"get":{"tags":["趣味工具"],"summary":"转换颜色格式并计算 WCAG 对比度","description":"_format=svg 返回原色、更亮、更暗和补色的色板，公开缓存 1 天。对比度按不透明 RGB 计算。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":9,"example":"336699","description":"3、4、6 或 8 位十六进制，可带 #"},"required":true,"description":"3、4、6 或 8 位十六进制，可带 #","name":"hex","in":"path"},{"schema":{"type":"string","minLength":3,"maxLength":9,"description":"可选的对照色"},"required":false,"description":"可选的对照色","name":"against","in":"query"},{"$ref":"#/components/parameters/FormatImage"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"颜色分量、CSS 写法、相对亮度和 WCAG 对比度。_format=svg 时为色板。","content":{"application/json":{"schema":{"type":"object","properties":{"hex":{"type":"string"},"rgb":{"type":"object","properties":{"r":{"type":"number"},"g":{"type":"number"},"b":{"type":"number"},"a":{"type":"number"}},"required":["r","g","b","a"]},"hsl":{"type":"object","properties":{"h":{"type":"number"},"s":{"type":"number"},"l":{"type":"number"}},"required":["h","s","l"]},"css":{"type":"object","properties":{"hex":{"type":"string"},"rgb":{"type":"string"},"hsl":{"type":"string"}},"required":["hex","rgb","hsl"]},"luminance":{"type":"number"},"contrast":{"type":"object","properties":{"black":{"type":"object","properties":{"ratio":{"type":"number"},"aa":{"type":"boolean"},"aaa":{"type":"boolean"},"aaLarge":{"type":"boolean"},"aaaLarge":{"type":"boolean"}},"required":["ratio","aa","aaa","aaLarge","aaaLarge"]},"white":{"type":"object","properties":{"ratio":{"type":"number"},"aa":{"type":"boolean"},"aaa":{"type":"boolean"},"aaLarge":{"type":"boolean"},"aaaLarge":{"type":"boolean"}},"required":["ratio","aa","aaa","aaLarge","aaaLarge"]},"against":{"type":["object","null"],"properties":{"ratio":{"type":"number"},"aa":{"type":"boolean"},"aaa":{"type":"boolean"},"aaLarge":{"type":"boolean"},"aaaLarge":{"type":"boolean"}},"required":["ratio","aa","aaa","aaLarge","aaaLarge"]}},"required":["black","white","against"]}},"required":["hex","rgb","hsl","css","luminance","contrast"],"additionalProperties":{}}},"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/lorem/zh":{"get":{"tags":["趣味工具"],"summary":"按内置风格生成中文假文","parameters":[{"schema":{"type":"string","enum":["baihua","wenyan","tech","poetry"],"default":"baihua","description":"baihua 白话、wenyan 文言、tech 技术说明、poetry 短句"},"required":false,"description":"baihua 白话、wenyan 文言、tech 技术说明、poetry 短句","name":"style","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":6,"default":2},"required":false,"name":"paragraphs","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":8,"default":3},"required":false,"name":"sentences","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"style":{"type":"string","enum":["baihua","wenyan","tech","poetry"]},"paragraphs":{"type":"array","items":{"type":"string"}}},"required":["style","paragraphs"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/fortune":{"get":{"tags":["趣味工具"],"summary":"返回一条内置随机签语","description":"签语写在程序里，不记录请求。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"id":{"type":"integer"}},"required":["text","id"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]}},"/excuse":{"get":{"tags":["趣味工具"],"summary":"返回一条内置程序员借口","description":"借口写在程序里，不记录请求。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"id":{"type":"integer"}},"required":["text","id"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]}},"/roll/{dice}":{"get":{"tags":["趣味工具"],"summary":"按骰子表达式掷骰并返回每颗点数","description":"支持 3d6、d20、1d20+5、2d6+1d8-1。每组 1–100 颗、2–1000 面，总共最多 100 颗、10 组。点数来自 crypto.getRandomValues 的拒绝采样。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":64,"example":"3d6"},"required":true,"name":"dice","in":"path"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"sides":{"type":"integer"},"sign":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[-1]}]},"rolls":{"type":"array","items":{"type":"integer"}},"subtotal":{"type":"integer"}},"required":["count","sides","sign","rolls","subtotal"]}},"modifier":{"type":"integer"},"total":{"type":"integer"}},"required":["expression","groups","modifier","total"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/coin":{"get":{"tags":["趣味工具"],"summary":"抛一枚或多枚硬币","description":"n 默认 1，最大 64。正反面由拒绝采样生成。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":64,"default":1},"required":false,"name":"n","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"n":{"type":"integer"},"flips":{"type":"array","items":{"type":"string","enum":["heads","tails"]}},"heads":{"type":"integer"},"tails":{"type":"integer"}},"required":["n","flips","heads","tails"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/8ball":{"get":{"tags":["趣味工具"],"summary":"回答魔法八号球问题","description":"答案写在程序里。q 可选，最多 200 字符，只出现在这一次响应中。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","maxLength":200},"required":false,"name":"q","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":["string","null"]},"answer":{"type":"string"}},"required":["question","answer"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/uuid/v7":{"get":{"tags":["随机数据"],"summary":"生成 UUID v7","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string"}},"required":["uuid"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/ulid":{"get":{"tags":["随机数据"],"summary":"生成 ULID","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"ulid":{"type":"string"}},"required":["ulid"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/nanoid":{"get":{"tags":["随机数据"],"summary":"生成 URL 安全的 NanoID","description":"size 默认 21，范围 1–64。字母表长度为 64，拒绝采样避免取模偏差。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":64,"default":21},"required":false,"name":"size","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"size":{"type":"integer"}},"required":["id","size"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/snowflake/decode":{"get":{"tags":["随机数据"],"summary":"解码 Discord 或 X 的雪花 ID","description":"Discord 纪元为 2015-01-01，X 与 Twitter 纪元为 1288834974657。ID 按十进制字符串解析，避免超过安全整数。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","pattern":"^\\d{1,20}$","example":"175928847299117063"},"required":true,"name":"id","in":"query"},{"schema":{"type":"string","enum":["discord","twitter","x"],"default":"discord"},"required":false,"name":"epoch","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"epoch":{"type":"string","enum":["discord","twitter","x"]},"timestamp":{"type":"string"},"iso":{"type":"string"},"worker":{"type":"integer"},"process":{"type":["integer","null"]},"sequence":{"type":"integer"}},"required":["id","epoch","timestamp","iso","worker","process","sequence"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/time/convert":{"get":{"tags":["时间与计划"],"summary":"按 IANA 时区换算时间","description":"datetime 省略时使用当前时间。没有偏移的时间按 from 解释为本地时间。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":10,"maxLength":40,"example":"2026-01-01T00:00:00Z"},"required":false,"name":"datetime","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":128,"default":"UTC"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":128,"default":"Asia/Shanghai"},"required":false,"name":"to","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"utc":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"}},"required":["from","to","utc","source","target"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/cron/explain":{"get":{"tags":["时间与计划"],"summary":"把 Cron 翻译成人话并列出后续运行时间","description":"五字段或与 /cron 相同的宏。n 为 1–10。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":256,"example":"0 3 * * *"},"required":true,"name":"expr","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":128,"default":"UTC"},"required":false,"name":"tz","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":10,"default":3},"required":false,"name":"n","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"from","in":"query"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"expr":{"type":"string"},"tz":{"type":"string"},"summary":{"type":"string"},"from":{"type":"string"},"next":{"type":"array","items":{"type":"string"}}},"required":["expr","tz","summary","from","next"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/ordered-digit-solver":{"post":{"tags":["数学求解"],"summary":"按顺序使用全部数字，同步返回首个精确解","description":"支持 +、-、*、/、整数次幂、阶乘和取负。每个中间数约分后的分子绝对值与分母均小于 2^128；整数指数绝对值最多 12；阶乘参数为 0–12 的整数；全表达式最多 2 个一元运算，一元连续嵌套深度最多 2。排除除零、0^0 和零的负次幂。固定遍历顺序，找到首个解立即返回。no_solution 表示上述有限规则范围内确认无解；limit_reached 表示搜索预算耗尽。\n访问类别：匿名 API，可携带 Token 使用独立额度","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"digits":{"type":"string","minLength":1,"maxLength":10,"pattern":"^[0-9]+$","description":"按原始顺序逐个使用全部数字，每个数字独立参与运算","example":"350234"},"target":{"type":"string","minLength":1,"maxLength":80,"pattern":"^-?(?:\\d+(?:\\.\\d+)?|\\d+\\/[1-9]\\d*)$","description":"精确目标值，支持整数、有限小数及分数，例如 325、0.1、1/3","example":"325"}},"required":["digits","target"],"additionalProperties":false}}}},"responses":{"200":{"description":"found、规则范围内确认无解，或达到搜索限制","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["found","no_solution","limit_reached"]},"expression":{"type":["string","null"],"description":"found 时返回使用 ^ 表示乘方、! 表示阶乘的完整括号表达式"},"value":{"type":["string","null"],"description":"found 时返回约分后的精确整数或分数"},"rulesVersion":{"type":"string"},"limits":{"type":"object","properties":{"maxDigits":{"type":"integer"},"maxUnaryOperators":{"type":"integer"},"maxUnaryDepth":{"type":"integer"},"maxFactorialArgument":{"type":"integer"},"maxAbsoluteExponent":{"type":"integer"},"maxValueBits":{"type":"integer"},"maxStates":{"type":"integer"},"maxWork":{"type":"integer"}},"required":["maxDigits","maxUnaryOperators","maxUnaryDepth","maxFactorialArgument","maxAbsoluteExponent","maxValueBits","maxStates","maxWork"]},"terminationReason":{"type":["string","null"],"enum":["max_work","max_states",null]},"stats":{"type":"object","properties":{"work":{"type":"integer"},"states":{"type":"integer"}},"required":["work","states"]}},"required":["status","expression","value","rulesVersion","limits","terminationReason","stats"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/generate_204":{"get":{"tags":["HTTP 调试"],"summary":"返回 204 连通性响应","description":"支持 GET 和 HEAD，返回空响应体，禁止缓存。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"204":{"description":"连通性检查成功，空响应体"},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/generate_204/non-cn":{"get":{"tags":["HTTP 调试"],"summary":"仅为非 CN 地区返回 204","description":"支持 GET 和 HEAD，依据 Cloudflare request.cf.country 判断地区。CN 单独匹配，HK、MO、TW 归入非 CN。地区缺失、XX 或 T1 返回 503。所有结果均为空响应体并禁止缓存。OPTIONS 使用公共跨域预检规则。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"204":{"description":"地区符合条件，空响应体"},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"地区不符合条件，空响应体"},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"无法确定访问者地区，空响应体"}}}},"/generate_204/cn":{"get":{"tags":["HTTP 调试"],"summary":"仅为 CN 地区返回 204","description":"支持 GET 和 HEAD，依据 Cloudflare request.cf.country 判断地区。CN 单独匹配，HK、MO、TW 归入非 CN。地区缺失、XX 或 T1 返回 503。所有结果均为空响应体并禁止缓存。OPTIONS 使用公共跨域预检规则。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"204":{"description":"地区符合条件，空响应体"},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"地区不符合条件，空响应体"},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"无法确定访问者地区，空响应体"}}}},"/ua":{"get":{"tags":["请求与设备信息"],"summary":"回显 User-Agent","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"userAgent":{"type":"string"}},"required":["userAgent"],"example":{"userAgent":"curl/8.0.0"}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/ua/analyze":{"get":{"tags":["请求与设备信息"],"summary":"分析 User-Agent","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"userAgent":"","browser":{},"os":{},"platform":{},"engine":{}},"schema":{"type":"object","properties":{"userAgent":{"type":"string"},"browser":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}}},"os":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"versionName":{"type":"string"}}},"platform":{"type":"object","properties":{"type":{"type":"string"},"vendor":{"type":"string"},"model":{"type":"string"}}},"engine":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"}}}},"required":["userAgent","browser","os","platform","engine"],"example":{"userAgent":"curl/8.0.0"}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/headers":{"get":{"tags":["请求与设备信息"],"summary":"查看请求头","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"headers":{"user-agent":"curl/8.0.0"}},"schema":{"type":"object","properties":{"headers":{"type":"object","additionalProperties":{"type":"string"}}},"required":["headers"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/ip":{"get":{"tags":["请求与设备信息"],"summary":"查看访问者 IP","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"ip":"203.0.113.10"},"schema":{"type":"object","properties":{"ip":{"type":["string","null"]}},"required":["ip"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/ip/analyze":{"get":{"tags":["请求与设备信息"],"summary":"查看 Cloudflare 访问者信息","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"ip":null,"source":"cloudflare","asn":null,"country":null,"city":null,"continent":null,"region":null,"regionCode":null,"postalCode":null,"timezone":null,"latitude":null,"longitude":null,"asOrganization":null},"schema":{"type":"object","properties":{"ip":{"type":["string","null"]},"source":{"type":"string","enum":["cloudflare"]},"asn":{"type":["number","null"]},"country":{"type":["string","null"]},"city":{"type":["string","null"]},"continent":{"type":["string","null"]},"region":{"type":["string","null"]},"regionCode":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"timezone":{"type":["string","null"]},"latitude":{"type":["string","null"]},"longitude":{"type":["string","null"]},"asOrganization":{"type":["string","null"]}},"required":["ip","source","asn","country","city","continent","region","regionCode","postalCode","timezone","latitude","longitude","asOrganization"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/visitor":{"get":{"tags":["请求与设备信息"],"summary":"查看访问者与 Cloudflare 连接信息","description":"返回当前请求的 Cloudflare 连接、地理和 TLS ClientHello 摘要。字段始终齐全，边缘未提供时为 null。tlsClient 始终为对象。不返回 tlsClientRandom。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"ip":null,"source":"cloudflare","country":null,"city":null,"continent":null,"region":null,"regionCode":null,"postalCode":null,"timezone":null,"latitude":null,"longitude":null,"asOrganization":null,"asn":null,"colo":null,"cfRay":null,"httpProtocol":null,"tlsVersion":null,"tlsCipher":null,"clientTcpRtt":null,"clientQuicRtt":null,"edgeL4":{"deliveryRate":null},"clientAcceptEncoding":null,"metroCode":null,"isEUCountry":null,"requestPriority":null,"tlsClient":{"helloLength":null,"ciphersSha1":null,"extensionsSha1":null,"extensionsSha1Le":null}},"schema":{"type":"object","properties":{"ip":{"type":["string","null"]},"source":{"type":"string","enum":["cloudflare"]},"country":{"type":["string","null"]},"city":{"type":["string","null"]},"continent":{"type":["string","null"]},"region":{"type":["string","null"]},"regionCode":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"timezone":{"type":["string","null"]},"latitude":{"type":["string","null"]},"longitude":{"type":["string","null"]},"asOrganization":{"type":["string","null"]},"asn":{"type":["integer","null"],"minimum":0},"colo":{"type":["string","null"],"description":"请求进入的 Cloudflare 数据中心 IATA 代码，例如 HKG"},"cfRay":{"type":["string","null"],"description":"Cloudflare 请求标识，来自 CF-Ray 请求头"},"httpProtocol":{"type":["string","null"]},"tlsVersion":{"type":["string","null"]},"tlsCipher":{"type":["string","null"]},"clientTcpRtt":{"type":["number","null"],"minimum":0,"description":"客户端到 Cloudflare 的平滑 TCP RTT，毫秒；仅适用于 TCP 连接"},"clientQuicRtt":{"type":["number","null"],"minimum":0,"description":"客户端到 Cloudflare 的平滑 QUIC RTT，毫秒；HTTP/3 连接返回平台测量值，其余协议返回 null"},"edgeL4":{"type":"object","properties":{"deliveryRate":{"type":["number","null"],"minimum":0,"description":"连接近期数据交付速率估计，字节/秒"}},"required":["deliveryRate"]},"clientAcceptEncoding":{"type":["string","null"],"description":"Cloudflare 保留的客户端原始 Accept-Encoding 声明"},"metroCode":{"type":["string","null"],"description":"都会区代码（DMA）。未知时为 null"},"isEUCountry":{"type":["boolean","null"],"description":"访问国家或地区是否属于欧盟。平台值 \"1\" 为 true，其他可判定值为 false，缺失为 null"},"requestPriority":{"type":["string","null"],"description":"浏览器在 HTTP/2 或 HTTP/3 中声明的请求优先级。无声明时为 null"},"tlsClient":{"type":"object","properties":{"helloLength":{"type":["integer","null"],"minimum":0,"description":"TLS ClientHello 消息的字节长度。平台多以数字字符串提供，非数字或缺失时为 null"},"ciphersSha1":{"type":["string","null"],"description":"客户端密码套件列表的 SHA-1，Base64，大端"},"extensionsSha1":{"type":["string","null"],"description":"客户端 TLS 扩展的 SHA-1，Base64，大端"},"extensionsSha1Le":{"type":["string","null"],"description":"客户端 TLS 扩展的 SHA-1，Base64，小端"}},"required":["helloLength","ciphersSha1","extensionsSha1","extensionsSha1Le"],"description":"TLS ClientHello 摘要。边缘未提供时四个子字段均为 null。不包含握手随机数 tlsClientRandom"}},"required":["ip","source","country","city","continent","region","regionCode","postalCode","timezone","latitude","longitude","asOrganization","asn","colo","cfRay","httpProtocol","tlsVersion","tlsCipher","clientTcpRtt","clientQuicRtt","edgeL4","clientAcceptEncoding","metroCode","isEUCountry","requestPriority","tlsClient"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]}},"/echo":{"post":{"tags":["HTTP 调试"],"summary":"回显原始请求体","requestBody":{"content":{"*/*":{"schema":{"type":"string","format":"binary","example":"hello"}}}},"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"method":"POST","contentType":"text/plain","body":"hello","bodyBase64":"aGVsbG8=","bytes":5},"schema":{"type":"object","properties":{"method":{"type":"string","enum":["POST"]},"contentType":{"type":["string","null"]},"body":{"type":"string"},"bodyBase64":{"type":"string"},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","contentType","body","bodyBase64","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/delay/{seconds}":{"get":{"tags":["HTTP 调试"],"summary":"延迟响应","parameters":[{"schema":{"type":"number","minimum":0,"maximum":10,"multipleOf":0.001,"example":0.15},"required":true,"name":"seconds","in":"path"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"seconds":0.15},"schema":{"type":"object","properties":{"seconds":{"type":"number","minimum":0,"maximum":10}},"required":["seconds"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/status/{code}/html":{"get":{"tags":["HTTP 调试"],"summary":"返回指定状态码的错误页面","description":"支持 GET 和 HEAD。实际 HTTP 状态码与 code 一致，支持 400–599。已知状态码使用标准英文说明，未定义状态码显示 Unknown HTTP Status。参数无效时返回 HTTP 400 和 ApiError JSON。响应禁止缓存。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"integer","minimum":400,"maximum":599,"example":404,"description":"需要返回的 HTTP 错误状态码，范围 400–599"},"required":true,"description":"需要返回的 HTTP 错误状态码，范围 400–599","name":"code","in":"path"}],"responses":{"400":{"description":"code 为 400 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"text/html":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"code 为 413 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"text/html":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"code 为 415 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"text/html":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"code 为 429 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"text/html":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"code 为 500 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"text/html":{"schema":{"type":"string"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"4XX":{"description":"指定的客户端错误状态码","content":{"text/html":{"schema":{"type":"string"}}}},"5XX":{"description":"指定的服务器错误状态码","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/status/{code}/json":{"get":{"tags":["HTTP 调试"],"summary":"返回指定状态码的错误 JSON","description":"支持 GET 和 HEAD。实际 HTTP 状态码与 code 一致，支持 400–599。已知状态码使用标准英文说明，未定义状态码显示 Unknown HTTP Status。参数无效时返回 HTTP 400 和 ApiError JSON。响应禁止缓存。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"integer","minimum":400,"maximum":599,"example":404,"description":"需要返回的 HTTP 错误状态码，范围 400–599"},"required":true,"description":"需要返回的 HTTP 错误状态码，范围 400–599","name":"code","in":"path"}],"responses":{"400":{"description":"code 为 400 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},{"$ref":"#/components/schemas/ApiError"}]}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"code 为 413 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},{"$ref":"#/components/schemas/ApiError"}]}}}},"415":{"description":"code 为 415 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},{"$ref":"#/components/schemas/ApiError"}]}}}},"429":{"description":"code 为 429 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},{"$ref":"#/components/schemas/ApiError"}]}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"code 为 500 时返回指定错误内容；请求校验或执行失败时返回 ApiError JSON","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},{"$ref":"#/components/schemas/ApiError"}]}}}},"4XX":{"description":"指定的客户端错误状态码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"],"example":{"error":{"code":404,"message":"Not Found"}}}}}},"5XX":{"description":"指定的服务器错误状态码","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"integer","minimum":400,"maximum":599},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"],"example":{"error":{"code":404,"message":"Not Found"}}}}}}}}},"/status/{code}":{"get":{"tags":["HTTP 调试"],"summary":"返回指定状态码","parameters":[{"schema":{"type":"integer","minimum":200,"maximum":599,"example":200},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"指定状态码，响应体为空"},"400":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"有效 code 返回指定状态码和空响应体；请求校验或执行失败时可能返回 application/json 格式的 ApiError。客户端应先检查响应体是否为空。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"2XX":{"description":"指定状态码，响应体为空"},"3XX":{"description":"指定状态码，响应体为空"},"4XX":{"description":"指定状态码，响应体为空"},"5XX":{"description":"指定状态码，响应体为空"}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/status/{code}/detail":{"get":{"tags":["HTTP 调试"],"summary":"查看状态码说明","parameters":[{"schema":{"type":"integer","minimum":200,"maximum":599,"example":200},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"code":404,"description":"Not Found"},"schema":{"type":"object","properties":{"code":{"type":"integer","minimum":200,"maximum":599},"description":{"type":["string","null"]}},"required":["code","description"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/redirect/{count}":{"get":{"tags":["HTTP 调试"],"summary":"执行有限重定向","parameters":[{"schema":{"type":"integer","minimum":0,"maximum":20,"example":1},"required":true,"name":"count","in":"path"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"remaining":0},"schema":{"type":"object","properties":{"remaining":{"type":"number","enum":[0]}},"required":["remaining"]}}}},"302":{"description":"继续同源重定向","headers":{"Location":{"schema":{"type":"string","example":"/redirect/0"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/cookies":{"get":{"tags":["HTTP 调试"],"summary":"读取 Cookie","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"cookies":{"test-cookie":"你好 test"}},"schema":{"type":"object","properties":{"cookies":{"type":"object","additionalProperties":{"type":"string"}}},"required":["cookies"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"},"post":{"tags":["HTTP 调试"],"summary":"设置同源 Cookie","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[!#$%&'*+.^_`|~0-9A-Za-z-]+$","example":"test-cookie"},"value":{"type":"string","maxLength":1024,"example":"你好 test"}},"required":["name","value"],"example":{"name":"test-cookie","value":"你好 test"}}}}},"responses":{"200":{"description":"请求处理结果","headers":{"Set-Cookie":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[!#$%&'*+.^_`|~0-9A-Za-z-]+$","example":"test-cookie"},"value":{"type":"string","maxLength":1024,"example":"你好 test"}},"required":["name","value"],"example":{"name":"test-cookie","value":"你好 test"}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/cookies/{name}":{"delete":{"tags":["HTTP 调试"],"summary":"删除同源 Cookie","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[!#$%&'*+.^_`|~0-9A-Za-z-]+$","example":"test-cookie"},"required":true,"name":"name","in":"path"}],"responses":{"200":{"description":"请求处理结果","headers":{"Set-Cookie":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"name":"test-cookie","deleted":true},"schema":{"type":"object","properties":{"name":{"type":"string"},"deleted":{"type":"boolean","enum":[true]}},"required":["name","deleted"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/gzip":{"get":{"tags":["HTTP 调试"],"summary":"返回 gzip 数据","responses":{"200":{"description":"gzip 编码的 JSON","headers":{"Content-Encoding":{"schema":{"type":"string","enum":["gzip"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"compressed":{"type":"boolean","enum":[true]}},"required":["compressed"],"example":{"compressed":true}}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/bytes/{count}":{"get":{"tags":["HTTP 调试"],"summary":"生成随机字节","parameters":[{"schema":{"type":"integer","minimum":0,"maximum":65536,"example":1},"required":true,"name":"count","in":"path"}],"responses":{"200":{"description":"随机字节","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/stream/{count}":{"get":{"tags":["HTTP 调试"],"summary":"逐步输出 NDJSON","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"example":1},"required":true,"name":"count","in":"path"}],"responses":{"200":{"description":"每行一个对象，index 从 0 开始，行间隔 50 毫秒","content":{"application/x-ndjson":{"schema":{"type":"string","example":"{\"index\":0}\n{\"index\":1}\n"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/anything":{"get":{"tags":["HTTP 调试"],"summary":"回显请求的方法、查询、请求头和正文","description":"无状态回显。过滤 Authorization、Proxy-Authorization、Cookie 和 Cf-Access-Jwt-Assertion。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"string"},"json":{},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","url","path","query","headers","body","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]},"post":{"tags":["HTTP 调试"],"summary":"回显请求的方法、查询、请求头和正文","description":"无状态回显。过滤 Authorization、Proxy-Authorization、Cookie 和 Cf-Access-Jwt-Assertion。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"string"},"json":{},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","url","path","query","headers","body","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]},"put":{"tags":["HTTP 调试"],"summary":"回显请求的方法、查询、请求头和正文","description":"无状态回显。过滤 Authorization、Proxy-Authorization、Cookie 和 Cf-Access-Jwt-Assertion。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"string"},"json":{},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","url","path","query","headers","body","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]},"patch":{"tags":["HTTP 调试"],"summary":"回显请求的方法、查询、请求头和正文","description":"无状态回显。过滤 Authorization、Proxy-Authorization、Cookie 和 Cf-Access-Jwt-Assertion。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"string"},"json":{},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","url","path","query","headers","body","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]},"delete":{"tags":["HTTP 调试"],"summary":"回显请求的方法、查询、请求头和正文","description":"无状态回显。过滤 Authorization、Proxy-Authorization、Cookie 和 Cf-Access-Jwt-Assertion。\n访问类别：匿名 API，可携带 Token 使用独立额度","responses":{"200":{"description":"请求处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string"},"url":{"type":"string"},"path":{"type":"string"},"query":{"type":"object","additionalProperties":{"type":"string"}},"headers":{"type":"object","additionalProperties":{"type":"string"}},"body":{"type":"string"},"json":{},"bytes":{"type":"integer","minimum":0,"maximum":65536}},"required":["method","url","path","query","headers","body","bytes"]}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text","parameters":[{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}]}},"/drip":{"get":{"tags":["HTTP 调试"],"summary":"按上限内的间隔输出字节","description":"先等待 delay 秒，再把 numbytes 个 0x2A 字节分散到 duration 秒内。delay 与 duration 各最大 10 秒，numbytes 最大 4096。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":["number","null"],"minimum":0,"maximum":10,"default":0},"required":false,"name":"duration","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"maximum":10,"default":0},"required":false,"name":"delay","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":4096,"default":10},"required":false,"name":"numbytes","in":"query"}],"responses":{"200":{"description":"按间隔输出的星号字节","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/basic-auth/{user}/{password}":{"get":{"tags":["HTTP 调试"],"summary":"对照 URL 中的测试凭据检查 Basic 认证","description":"无状态对照。URL 中的用户名和密码是本次期望值，不落库。Basic 方案不进入 API Token 认证；其他 Authorization 仍按 Token 处理。失败返回 401 和 WWW-Authenticate。不要把真实密码放进 URL，访问日志可能记录路径。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\u0020-\\u007e]+$","description":"可打印 ASCII，1–64 字符。这是期望的测试值，不会被保存。","example":"demo"},"required":true,"description":"可打印 ASCII，1–64 字符。这是期望的测试值，不会被保存。","name":"user","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\u0020-\\u007e]+$","description":"可打印 ASCII，1–64 字符。这是期望的测试值，不会被保存。","example":"secret"},"required":true,"description":"可打印 ASCII，1–64 字符。这是期望的测试值，不会被保存。","name":"password","in":"path"},{"$ref":"#/components/parameters/FormatData"},{"$ref":"#/components/parameters/Color"}],"responses":{"200":{"description":"请求处理结果","content":{"application/json":{"example":{"authenticated":true,"user":"demo"},"schema":{"type":"object","properties":{"authenticated":{"type":"boolean","enum":[true]},"user":{"type":"string"}},"required":["authenticated","user"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-cli-text":"text"}},"/dns":{"get":{"tags":["网络查询"],"summary":"查询 DNS 记录","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253,"pattern":"^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.?$","example":"example.com"},"required":true,"name":"name","in":"query"},{"schema":{"type":"string","enum":["A","AAAA","CNAME","MX","TXT"],"description":"省略时查询全部五类记录","example":"A"},"required":false,"description":"省略时查询全部五类记录","name":"type","in":"query"}],"responses":{"200":{"description":"DNS 查询结果；empty 表示缺少请求类型的记录，仍保留 CNAME 链；nxdomain 表示域名不存在","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["A","AAAA","CNAME","MX","TXT"]},"status":{"type":"string","enum":["ok","empty","nxdomain"]},"records":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"integer"},"ttl":{"type":"number","minimum":0},"data":{"type":"string"}},"required":["name","type","ttl","data"]}}},"required":["type","status","records"]},"minItems":1,"maxItems":5}},"required":["name","results"],"example":{"name":"example.com","results":[{"type":"A","status":"ok","records":[{"name":"example.com","type":1,"ttl":300,"data":"93.184.215.14"}]}]}}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/java":{"get":{"tags":["Minecraft"],"summary":"查询 Minecraft Java 状态与 MOTD","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253,"example":"mc.hypixel.net"},"required":true,"name":"host","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":65535,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","example":25565},"required":false,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","name":"port","in":"query"}],"responses":{"200":{"description":"服务器状态；latencyMs 包括 SRV、地址解析、TCP 连接与状态响应","content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"address":{"type":"string"},"resolved":{"type":"object","properties":{"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"srv":{"type":["object","null"],"properties":{"target":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"priority":{"type":"integer","minimum":0,"maximum":65535},"weight":{"type":"integer","minimum":0,"maximum":65535}},"required":["target","port","priority","weight"]}},"required":["host","port","srv"]},"version":{"type":"object","properties":{"name":{"type":"string"},"protocol":{"type":"integer"}},"required":["name","protocol"]},"players":{"type":"object","properties":{"online":{"type":"integer","minimum":0},"max":{"type":"integer","minimum":0},"sample":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name","id"]}}},"required":["online","max","sample"]},"motd":{},"motdText":{"type":"string"},"motdFormatted":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"underlined":{"type":"boolean"},"strikethrough":{"type":"boolean"},"obfuscated":{"type":"boolean"}},"required":["text","color","bold","italic","underlined","strikethrough","obfuscated"]}},"favicon":{"type":["string","null"]},"rawStatus":{"type":"object","additionalProperties":true,"description":"服务器返回的完整状态 JSON，保留嵌套对象中的扩展字段。"},"extensions":{"type":"object","additionalProperties":true,"description":"除 version、players、description、favicon 外的全部原始顶层字段，包含 Forge、其他服务端和自定义元数据。"},"modLoaders":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"source":{"type":"string"},"encoding":{"type":"string","enum":["json","optimized"]},"fmlNetworkVersion":{"type":["integer","null"]},"truncated":{"type":["boolean","null"]},"mods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":["string","null"]},"marker":{"type":["string","null"]}},"required":["id","version","marker"]}},"channels":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"version":{"anyOf":[{"type":"string"},{"type":"integer"}]},"required":{"type":"boolean"}},"required":["name","version","required"]}}},"required":["type","source","encoding","fmlNetworkVersion","truncated","mods","channels"]},"description":"从 modinfo 和 forgeData 整理的模组及通道信息；marker 为兼容性标记；truncated 为 null 表示服务器未声明列表完整性。"},"latencyMs":{"type":"integer","minimum":0},"timings":{"type":"object","properties":{"dnsMs":{"type":"integer","minimum":0},"connectMs":{"type":"integer","minimum":0},"statusMs":{"type":"integer","minimum":0}},"required":["dnsMs","connectMs","statusMs"]}},"required":["host","port","address","resolved","version","players","motdText","motdFormatted","favicon","rawStatus","extensions","modLoaders","latencyMs","timings"],"description":"原始 MOTD、纯文本与格式片段；favicon 为经过校验的 64×64 PNG data URL；players.sample 为服务器提供的样本，缺少时为 null。port 保留请求端口（省略时 25565），resolved 表示实际连接目标。timings 各阶段之和等于 latencyMs，均由 Worker 测量。"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/java/badge":{"get":{"tags":["Minecraft"],"summary":"Minecraft Java 在线人数徽章","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253,"example":"mc.hypixel.net"},"required":true,"name":"host","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":65535,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","example":25565},"required":false,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","name":"port","in":"query"}],"responses":{"200":{"description":"人数 SVG 徽章，缓存 30 秒","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/java/card":{"get":{"tags":["Minecraft"],"summary":"Minecraft Java 服务器状态卡片","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253,"example":"mc.hypixel.net"},"required":true,"name":"host","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":65535,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","example":25565},"required":false,"description":"显式填写时使用该端口；省略时对域名查询 SRV，无 SRV 时使用 25565","name":"port","in":"query"},{"schema":{"type":"string","enum":["default","classic","emerald","light","compact"],"default":"default","description":"default 现有深蓝、classic 游戏风格、emerald 翡翠深色、light 简洁浅色、compact 紧凑横幅","example":"emerald"},"required":false,"description":"default 现有深蓝、classic 游戏风格、emerald 翡翠深色、light 简洁浅色、compact 紧凑横幅","name":"theme","in":"query"}],"responses":{"200":{"description":"五种样式的 SVG，含服务器图标、彩色 MOTD、版本、人数和 Worker 查询耗时；缓存 30 秒","content":{"image/svg+xml":{"schema":{"type":"string"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/rdap/domain":{"get":{"tags":["网络查询"],"summary":"查询域名 RDAP","description":"按 IANA dns.json 的最长域名后缀选择注册局，查询域名 RDAP。只使用 HTTPS，不查询 WHOIS。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253,"pattern":"^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)*[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.?$","example":"example.com","description":"ASCII 域名，最长 253 字符。忽略一个结尾点，不区分大小写。国际化域名请使用 Punycode。"},"required":true,"description":"ASCII 域名，最长 253 字符。忽略一个结尾点，不区分大小写。国际化域名请使用 Punycode。","name":"name","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"true 时在 raw 返回注册局原始 RDAP JSON","example":"false"},"required":false,"description":"true 时在 raw 返回注册局原始 RDAP JSON","name":"raw","in":"query"}],"responses":{"200":{"description":"域名注册数据。成功结果缓存 300 秒。","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["domain","ip","asn"]},"query":{"type":"string"},"service":{"type":"string","description":"命中的 IANA 引导项，例如 com、8.0.0.0/8 或 13312-15359"},"registry":{"type":"string","description":"选中的 HTTPS RDAP 基址"},"objectClass":{"type":"string"},"handle":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":"array","items":{"type":"string"}},"dates":{"type":"object","properties":{"registration":{"type":["string","null"]},"expiration":{"type":["string","null"]},"lastChanged":{"type":["string","null"]},"lastUpdateOfRdap":{"type":["string","null"]}},"required":["registration","expiration","lastChanged","lastUpdateOfRdap"],"description":"保留注册局返回的时间原文；缺失为 null"},"events":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"date":{"type":"string"}},"required":["action","date"]}},"entities":{"type":"array","items":{"type":"object","properties":{"handle":{"type":["string","null"]},"roles":{"type":"array","items":{"type":"string"}},"name":{"type":["string","null"]},"kind":{"type":["string","null"]}},"required":["handle","roles","name","kind"]}},"nameservers":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"ipv4":{"type":"array","items":{"type":"string"}},"ipv6":{"type":"array","items":{"type":"string"}}},"required":["name","ipv4","ipv6"]},"description":"仅域名对象提供；IP 与 ASN 为 null"},"network":{"type":["object","null"],"properties":{"startAddress":{"type":"string"},"endAddress":{"type":"string"},"ipVersion":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"parentHandle":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["startAddress","endAddress","ipVersion","name","type","parentHandle","country"]},"asn":{"type":["object","null"],"properties":{"start":{"type":"integer"},"end":{"type":"integer"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["start","end","name","type","country"]},"links":{"type":"array","items":{"type":"object","properties":{"rel":{"type":["string","null"]},"href":{"type":"string"},"type":{"type":["string","null"]}},"required":["rel","href","type"]}},"raw":{"description":"raw=true 时为注册局返回的 RDAP JSON；默认省略"}},"required":["type","query","service","registry","objectClass","handle","name","status","dates","events","entities","nameservers","network","asn","links"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/rdap/ip":{"get":{"tags":["网络查询"],"summary":"查询 IP 地址 RDAP","description":"按 IANA ipv4.json 或 ipv6.json 的最长前缀选择注册局，查询 IP 网络 RDAP。只使用 HTTPS，不查询 WHOIS。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128,"example":"8.8.8.8","description":"IPv4、IPv6，或 IPv4 映射的 IPv6。映射地址按 IPv4 查询。"},"required":true,"description":"IPv4、IPv6，或 IPv4 映射的 IPv6。映射地址按 IPv4 查询。","name":"address","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"true 时在 raw 返回注册局原始 RDAP JSON","example":"false"},"required":false,"description":"true 时在 raw 返回注册局原始 RDAP JSON","name":"raw","in":"query"}],"responses":{"200":{"description":"IP 网络注册数据。成功结果缓存 300 秒。","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["domain","ip","asn"]},"query":{"type":"string"},"service":{"type":"string","description":"命中的 IANA 引导项，例如 com、8.0.0.0/8 或 13312-15359"},"registry":{"type":"string","description":"选中的 HTTPS RDAP 基址"},"objectClass":{"type":"string"},"handle":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":"array","items":{"type":"string"}},"dates":{"type":"object","properties":{"registration":{"type":["string","null"]},"expiration":{"type":["string","null"]},"lastChanged":{"type":["string","null"]},"lastUpdateOfRdap":{"type":["string","null"]}},"required":["registration","expiration","lastChanged","lastUpdateOfRdap"],"description":"保留注册局返回的时间原文；缺失为 null"},"events":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"date":{"type":"string"}},"required":["action","date"]}},"entities":{"type":"array","items":{"type":"object","properties":{"handle":{"type":["string","null"]},"roles":{"type":"array","items":{"type":"string"}},"name":{"type":["string","null"]},"kind":{"type":["string","null"]}},"required":["handle","roles","name","kind"]}},"nameservers":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"ipv4":{"type":"array","items":{"type":"string"}},"ipv6":{"type":"array","items":{"type":"string"}}},"required":["name","ipv4","ipv6"]},"description":"仅域名对象提供；IP 与 ASN 为 null"},"network":{"type":["object","null"],"properties":{"startAddress":{"type":"string"},"endAddress":{"type":"string"},"ipVersion":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"parentHandle":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["startAddress","endAddress","ipVersion","name","type","parentHandle","country"]},"asn":{"type":["object","null"],"properties":{"start":{"type":"integer"},"end":{"type":"integer"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["start","end","name","type","country"]},"links":{"type":"array","items":{"type":"object","properties":{"rel":{"type":["string","null"]},"href":{"type":"string"},"type":{"type":["string","null"]}},"required":["rel","href","type"]}},"raw":{"description":"raw=true 时为注册局返回的 RDAP JSON；默认省略"}},"required":["type","query","service","registry","objectClass","handle","name","status","dates","events","entities","nameservers","network","asn","links"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/rdap/asn":{"get":{"tags":["网络查询"],"summary":"查询 ASN RDAP","description":"按 IANA asn.json 的最窄号码区间选择注册局，查询 ASN RDAP。只使用 HTTPS，不查询 WHOIS。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","pattern":"^(?:AS|as)?(?:0|[1-9]\\d{0,9})$","example":"15169","description":"0 到 4294967295 的 ASN，可带 AS 前缀"},"required":true,"description":"0 到 4294967295 的 ASN，可带 AS 前缀","name":"asn","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"true 时在 raw 返回注册局原始 RDAP JSON","example":"false"},"required":false,"description":"true 时在 raw 返回注册局原始 RDAP JSON","name":"raw","in":"query"}],"responses":{"200":{"description":"ASN 注册数据。成功结果缓存 300 秒。","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["domain","ip","asn"]},"query":{"type":"string"},"service":{"type":"string","description":"命中的 IANA 引导项，例如 com、8.0.0.0/8 或 13312-15359"},"registry":{"type":"string","description":"选中的 HTTPS RDAP 基址"},"objectClass":{"type":"string"},"handle":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"type":"array","items":{"type":"string"}},"dates":{"type":"object","properties":{"registration":{"type":["string","null"]},"expiration":{"type":["string","null"]},"lastChanged":{"type":["string","null"]},"lastUpdateOfRdap":{"type":["string","null"]}},"required":["registration","expiration","lastChanged","lastUpdateOfRdap"],"description":"保留注册局返回的时间原文；缺失为 null"},"events":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"date":{"type":"string"}},"required":["action","date"]}},"entities":{"type":"array","items":{"type":"object","properties":{"handle":{"type":["string","null"]},"roles":{"type":"array","items":{"type":"string"}},"name":{"type":["string","null"]},"kind":{"type":["string","null"]}},"required":["handle","roles","name","kind"]}},"nameservers":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":"string"},"ipv4":{"type":"array","items":{"type":"string"}},"ipv6":{"type":"array","items":{"type":"string"}}},"required":["name","ipv4","ipv6"]},"description":"仅域名对象提供；IP 与 ASN 为 null"},"network":{"type":["object","null"],"properties":{"startAddress":{"type":"string"},"endAddress":{"type":"string"},"ipVersion":{"type":"string"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"parentHandle":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["startAddress","endAddress","ipVersion","name","type","parentHandle","country"]},"asn":{"type":["object","null"],"properties":{"start":{"type":"integer"},"end":{"type":"integer"},"name":{"type":["string","null"]},"type":{"type":["string","null"]},"country":{"type":["string","null"]}},"required":["start","end","name","type","country"]},"links":{"type":"array","items":{"type":"object","properties":{"rel":{"type":["string","null"]},"href":{"type":"string"},"type":{"type":["string","null"]}},"required":["rel","href","type"]}},"raw":{"description":"raw=true 时为注册局返回的 RDAP JSON；默认省略"}},"required":["type","query","service","registry","objectClass","handle","name","status","dates","events","entities","nameservers","network","asn","links"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/minecraft/player":{"get":{"tags":["Minecraft"],"summary":"查询 Minecraft Java 玩家皮肤资料","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"}],"responses":{"200":{"description":"PlayerDB 提供 UUID、玩家名、模型及纹理 HTTPS 地址，playerDbUrl 为该 UUID 对应的上游 API 地址；没有对应纹理时为 null，缓存 300 秒","content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"playerDbUrl":{"type":"string","format":"uri","description":"该玩家 UUID 对应的 PlayerDB Minecraft Account Lookup API 地址","example":"https://playerdb.co/api/player/minecraft/069a79f444e94726a5befca90e38aaf5"},"model":{"type":"string","enum":["classic","slim"]},"skin":{"type":["string","null"]},"cape":{"type":["string","null"]}},"required":["uuid","name","playerDbUrl","model","skin","cape"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/skin":{"get":{"tags":["Minecraft"],"summary":"获取 Minecraft Java 原始皮肤","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"}],"responses":{"200":{"description":"PNG 图片；缓存 300 秒","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/cape":{"get":{"tags":["Minecraft"],"summary":"获取 Minecraft Java 原始披风","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"}],"responses":{"200":{"description":"PNG 图片；缓存 300 秒","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/avatar":{"get":{"tags":["Minecraft"],"summary":"生成 Minecraft Java 正面头像","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"},{"schema":{"type":"integer","minimum":16,"maximum":2048,"default":128,"description":"输出正方形 PNG 的边长，像素","example":128},"required":false,"description":"输出正方形 PNG 的边长，像素","name":"size","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"true","description":"是否显示皮肤外层"},"required":false,"description":"是否显示皮肤外层","name":"overlay","in":"query"}],"responses":{"200":{"description":"PNG 图片；缓存 300 秒","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/render":{"get":{"tags":["Minecraft"],"summary":"生成 Minecraft Java 自定义视角与姿势的立体图片","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"},{"schema":{"type":"integer","minimum":16,"maximum":2048,"default":128,"description":"输出正方形 PNG 的边长，像素","example":128},"required":false,"description":"输出正方形 PNG 的边长，像素","name":"size","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"true","description":"是否显示皮肤外层"},"required":false,"description":"是否显示皮肤外层","name":"overlay","in":"query"},{"schema":{"type":"string","enum":["head","bust","body"],"default":"body","description":"头部、半身或全身；头部忽略披风设置"},"required":false,"description":"头部、半身或全身；头部忽略披风设置","name":"view","in":"query"},{"schema":{"type":"string","enum":["standing","walking","running","waving","sitting"],"description":"站立、行走、奔跑、右手挥手或双腿前伸坐姿；省略时为 standing，与 rotations 互斥"},"required":false,"description":"站立、行走、奔跑、右手挥手或双腿前伸坐姿；省略时为 standing，与 rotations 互斥","name":"pose","in":"query"},{"schema":{"type":"string","maxLength":4096,"description":"部位旋转 JSON，与显式 pose 互斥。支持 head、cape、leftArm、rightArm、leftLeg、rightLeg；每个部位的 x/y/z 为 −180～180 度数值，可含小数。省略的部位和轴采用 standing 角度（披风 x=-10，其余为 0）。左右以角色自身为准；X 向角色左侧、Y 向下、Z 向前，按固定模型轴依次旋转 X、Y、Z，正角遵循右手规则。头部绕颈部中心旋转，四肢及披风绕连接点旋转。","example":"{\"head\":{\"y\":30},\"rightArm\":{\"x\":-45,\"z\":20},\"cape\":{\"x\":-25}}"},"required":false,"description":"部位旋转 JSON，与显式 pose 互斥。支持 head、cape、leftArm、rightArm、leftLeg、rightLeg；每个部位的 x/y/z 为 −180～180 度数值，可含小数。省略的部位和轴采用 standing 角度（披风 x=-10，其余为 0）。左右以角色自身为准；X 向角色左侧、Y 向下、Z 向前，按固定模型轴依次旋转 X、Y、Z，正角遵循右手规则。头部绕颈部中心旋转，四肢及披风绕连接点旋转。","name":"rotations","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"显示玩家披风；没有披风时返回 MC_CAPE_NOT_FOUND"},"required":false,"description":"显示玩家披风；没有披风时返回 MC_CAPE_NOT_FOUND","name":"cape","in":"query"},{"schema":{"type":["integer","null"],"minimum":-180,"maximum":180,"default":0,"description":"相对默认右前上方视角的水平旋转角度"},"required":false,"description":"相对默认右前上方视角的水平旋转角度","name":"yaw","in":"query"},{"schema":{"type":["integer","null"],"minimum":-90,"maximum":90,"default":0,"description":"相对默认视角的垂直旋转角度"},"required":false,"description":"相对默认视角的垂直旋转角度","name":"pitch","in":"query"},{"schema":{"type":"string","pattern":"^(transparent|[a-fA-F0-9]{6})$","default":"transparent","description":"transparent 或六位十六进制背景色，例如 ffffff"},"required":false,"description":"transparent 或六位十六进制背景色，例如 ffffff","name":"background","in":"query"}],"responses":{"200":{"description":"PNG 图片；缓存 300 秒","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/model":{"get":{"tags":["Minecraft"],"summary":"导出 Minecraft Java 三维 GLB 模型","parameters":[{"schema":{"type":"string","pattern":"^(?:[A-Za-z0-9_]{1,16}|[a-fA-F0-9]{32}|[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12})$","description":"Java 版玩家名或 UUID，UUID 可以包含连字符","example":"Dinnerbone"},"required":true,"description":"Java 版玩家名或 UUID，UUID 可以包含连字符","name":"player","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"true","description":"是否显示皮肤外层"},"required":false,"description":"是否显示皮肤外层","name":"overlay","in":"query"},{"schema":{"type":"string","enum":["head","bust","body"],"default":"body","description":"头部、半身或全身；头部忽略披风设置"},"required":false,"description":"头部、半身或全身；头部忽略披风设置","name":"view","in":"query"},{"schema":{"type":"string","enum":["standing","walking","running","waving","sitting"],"description":"站立、行走、奔跑、右手挥手或双腿前伸坐姿；省略时为 standing，与 rotations 互斥"},"required":false,"description":"站立、行走、奔跑、右手挥手或双腿前伸坐姿；省略时为 standing，与 rotations 互斥","name":"pose","in":"query"},{"schema":{"type":"string","maxLength":4096,"description":"部位旋转 JSON，与显式 pose 互斥。支持 head、cape、leftArm、rightArm、leftLeg、rightLeg；每个部位的 x/y/z 为 −180～180 度数值，可含小数。省略的部位和轴采用 standing 角度（披风 x=-10，其余为 0）。左右以角色自身为准；X 向角色左侧、Y 向下、Z 向前，按固定模型轴依次旋转 X、Y、Z，正角遵循右手规则。头部绕颈部中心旋转，四肢及披风绕连接点旋转。","example":"{\"head\":{\"y\":30},\"rightArm\":{\"x\":-45,\"z\":20},\"cape\":{\"x\":-25}}"},"required":false,"description":"部位旋转 JSON，与显式 pose 互斥。支持 head、cape、leftArm、rightArm、leftLeg、rightLeg；每个部位的 x/y/z 为 −180～180 度数值，可含小数。省略的部位和轴采用 standing 角度（披风 x=-10，其余为 0）。左右以角色自身为准；X 向角色左侧、Y 向下、Z 向前，按固定模型轴依次旋转 X、Y、Z，正角遵循右手规则。头部绕颈部中心旋转，四肢及披风绕连接点旋转。","name":"rotations","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"显示玩家披风；没有披风时返回 MC_CAPE_NOT_FOUND"},"required":false,"description":"显示玩家披风；没有披风时返回 MC_CAPE_NOT_FOUND","name":"cape","in":"query"}],"responses":{"200":{"description":"包含几何、部位节点、材质和内嵌 PNG 纹理的 GLB 模型；缓存 300 秒","content":{"model/gltf-binary":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/seed/versions":{"get":{"tags":["Minecraft"],"summary":"查询种子引擎支持版本和结构","responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"edition":{"type":"string","enum":["java"]},"engine":{"type":"string","enum":["cubiomes"]},"revision":{"type":"string"},"versions":{"type":"array","items":{"type":"string"}},"dimensions":{"type":"array","items":{"type":"string"}},"structures":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"label":{"type":"string"},"dimension":{"type":"string"},"since":{"type":"string"}},"required":["type","label","dimension","since"]}},"accuracy":{"type":"string"}},"required":["edition","engine","revision","versions","dimensions","structures","accuracy"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/seed/biomes":{"get":{"tags":["Minecraft"],"summary":"查询指定版本和维度的生物群系列表","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"largeBiomes","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"dimension":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"largeBiomes":{"type":"string","enum":["true","false"],"default":"false"},"accuracy":{"type":"string"},"biomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"]}}},"required":["seed","accuracy","biomes"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/seed/biome":{"get":{"tags":["Minecraft"],"summary":"按种子查询精确方块坐标的生物群系","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"largeBiomes","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"x","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"z","in":"query"},{"schema":{"type":["integer","null"],"minimum":-64,"maximum":319,"default":64},"required":false,"name":"y","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"dimension":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"largeBiomes":{"type":"string","enum":["true","false"],"default":"false"},"accuracy":{"type":"string"},"x":{"type":"number"},"y":{"type":"number"},"z":{"type":"number"},"biome":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"]}},"required":["seed","accuracy","x","y","z","biome"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/seed/map":{"get":{"tags":["Minecraft"],"summary":"生成指定范围的生物群系采样地图","description":"x、z 为左上角附近的方块坐标，向下取整到 scale 倍数。biomes 按行排列。scale 为低分辨率生成层，y 向下取整至 4 的倍数。bounds 为世界范围内的有效显示区域，最大边界为不包含的坐标。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"largeBiomes","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"x","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"z","in":"query"},{"schema":{"type":["integer","null"],"minimum":-64,"maximum":319,"default":64},"required":false,"name":"y","in":"query"},{"schema":{"type":"string","enum":["4","16","64","256"],"default":"16"},"required":false,"name":"scale","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":128,"default":96},"required":false,"name":"width","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":128,"default":96},"required":false,"name":"height","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"dimension":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"largeBiomes":{"type":"string","enum":["true","false"],"default":"false"},"accuracy":{"type":"string"},"origin":{"type":"object","properties":{"x":{"type":"number"},"z":{"type":"number"}},"required":["x","z"]},"bounds":{"type":"object","properties":{"minX":{"type":"number"},"minZ":{"type":"number"},"maxX":{"type":"number"},"maxZ":{"type":"number"}},"required":["minX","minZ","maxX","maxZ"]},"y":{"type":"number"},"scale":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"biomes":{"type":"array","items":{"type":"number"}},"palette":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"]}}},"required":["seed","accuracy","origin","bounds","y","scale","width","height","biomes","palette"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/minecraft/seed/structures":{"get":{"tags":["Minecraft"],"summary":"按种子查询附近自然结构的预测位置","description":"查询中心周围半径 radius 的圆形区域；结构通过放置及生物群系检查，地形条件需要游戏确认。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"largeBiomes","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"x","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"z","in":"query"},{"schema":{"type":"integer","minimum":16,"maximum":4096,"default":1024},"required":false,"name":"radius","in":"query"},{"schema":{"type":"string","enum":["village","desert_pyramid","jungle_temple","swamp_hut","igloo","ocean_ruin","shipwreck","monument","mansion","outpost","ruined_portal","ancient_city","trail_ruins","trial_chambers","stronghold","fortress","bastion","ruined_portal_nether","end_city"],"default":"village"},"required":false,"name":"type","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"dimension":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"largeBiomes":{"type":"string","enum":["true","false"],"default":"false"},"accuracy":{"type":"string"},"type":{"type":"string"},"radius":{"type":"number"},"center":{"type":"object","properties":{"x":{"type":"number"},"z":{"type":"number"}},"required":["x","z"]},"positions":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"z":{"type":"integer"},"chunkX":{"type":"integer"},"chunkZ":{"type":"integer"},"distance":{"type":"number"}},"required":["x","z","chunkX","chunkZ","distance"]}}},"required":["seed","accuracy","type","radius","center","positions"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/minecraft/seed/slime":{"get":{"tags":["Minecraft"],"summary":"按种子查询 Java 版史莱姆区块","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":["integer","null"],"minimum":-1875000,"maximum":1874999,"default":0},"required":false,"name":"chunkX","in":"query"},{"schema":{"type":["integer","null"],"minimum":-1875000,"maximum":1874999,"default":0},"required":false,"name":"chunkZ","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":16,"default":8},"required":false,"name":"radius","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string"},"dimension":{"type":"string","enum":["overworld"]},"radius":{"type":"number"},"center":{"type":"object","properties":{"chunkX":{"type":"number"},"chunkZ":{"type":"number"}},"required":["chunkX","chunkZ"]},"chunks":{"type":"array","items":{"type":"object","properties":{"chunkX":{"type":"number"},"chunkZ":{"type":"number"},"x":{"type":"number"},"z":{"type":"number"},"slime":{"type":"boolean"}},"required":["chunkX","chunkZ","x","z","slime"]}}},"required":["seed","version","dimension","radius","center","chunks"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/minecraft/seed/biomes/search":{"get":{"tags":["Minecraft"],"summary":"在限定范围内采样查找目标生物群系","description":"按 step 网格采样并以方块精度核验命中点。最多 16384 个样本；返回最近的已核验采样点及距离，空结果仅代表采样点没有命中。\n访问类别：匿名 API，可携带 Token 使用独立额度","parameters":[{"schema":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"required":true,"description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807","name":"seed","in":"query"},{"schema":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"required":false,"name":"version","in":"query"},{"schema":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"required":false,"name":"dimension","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"largeBiomes","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"x","in":"query"},{"schema":{"type":["integer","null"],"minimum":-30000000,"maximum":29999999,"default":0},"required":false,"name":"z","in":"query"},{"schema":{"type":["integer","null"],"minimum":-64,"maximum":319,"default":64},"required":false,"name":"y","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":255},"required":false,"name":"biome","in":"query"},{"schema":{"type":"integer","minimum":64,"maximum":2048,"default":1024},"required":false,"name":"radius","in":"query"},{"schema":{"type":"string","enum":["16","64","256"],"default":"64"},"required":false,"name":"step","in":"query"}],"responses":{"200":{"description":"Cubiomes 原版 Java 规则预测，缓存 3600 秒","content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string","example":"262","description":"完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"},"version":{"type":"string","enum":["1.16.5","1.17.1","1.18.2","1.19.2","1.19.4","1.20.6","1.21.1","1.21.3","1.21.4"],"default":"1.21.4"},"dimension":{"type":"string","enum":["overworld","nether","end"],"default":"overworld"},"largeBiomes":{"type":"string","enum":["true","false"],"default":"false"},"accuracy":{"type":"string"},"biome":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"]},"radius":{"type":"number"},"step":{"type":"number"},"samples":{"type":"number"},"position":{"type":["object","null"],"properties":{"x":{"type":"integer"},"z":{"type":"integer"},"chunkX":{"type":"integer"},"chunkZ":{"type":"integer"},"distance":{"type":"number"}},"required":["x","z","chunkX","chunkZ","distance"]}},"required":["seed","accuracy","biome","radius","step","samples","position"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/bing/info":{"get":{"tags":["Bing 壁纸"],"summary":"获取 Bing 日图信息","parameters":[{"schema":{"type":"string","enum":["zh-CN","en-US","ja-JP","en-IN","pt-BR","fr-FR","de-DE","en-CA","en-GB","it-IT","es-ES","fr-CA"],"default":"zh-CN","description":"Bing 日图地区","example":"zh-CN"},"required":false,"description":"Bing 日图地区","name":"mkt","in":"query"}],"responses":{"200":{"description":"D1 中的完整日图快照与可用版本列表，包含 updatedAt、expiresAt；香港时间每天 08:00 和 20:00 刷新，有效期 26 小时；响应公开缓存最长 300 秒并受快照有效期约束，顶层 url 指向最高质量版本","content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","enum":["zh-CN","en-US","ja-JP","en-IN","pt-BR","fr-FR","de-DE","en-CA","en-GB","it-IT","es-ES","fr-CA"]},"date":{"type":"string"},"endDate":{"type":"string"},"url":{"type":"string","format":"uri"},"title":{"type":"string"},"copyright":{"type":"string"},"copyrightUrl":{"type":"string","format":"uri"},"images":{"type":"array","items":{"type":"object","properties":{"resolution":{"type":"string","enum":["UHD","1920x1200","1920x1080","1366x768","1280x768","1024x768","800x600","800x480","1080x1920","768x1280","720x1280","640x480","480x800","400x240","320x240","240x320"]},"width":{"type":"integer","exclusiveMinimum":0},"height":{"type":"integer","exclusiveMinimum":0},"url":{"type":"string","format":"uri"}},"required":["resolution","width","height","url"]},"minItems":1},"updatedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}},"required":["market","date","endDate","url","title","copyright","copyrightUrl","images","updatedAt","expiresAt"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/bing":{"get":{"tags":["Bing 壁纸"],"summary":"获取 Bing 日图","parameters":[{"schema":{"type":"string","enum":["zh-CN","en-US","ja-JP","en-IN","pt-BR","fr-FR","de-DE","en-CA","en-GB","it-IT","es-ES","fr-CA"],"default":"zh-CN","description":"Bing 日图地区","example":"zh-CN"},"required":false,"description":"Bing 日图地区","name":"mkt","in":"query"},{"schema":{"type":"string","enum":["UHD","1920x1200","1920x1080","1366x768","1280x768","1024x768","800x600","800x480","1080x1920","768x1280","720x1280","640x480","480x800","400x240","320x240","240x320"],"description":"省略时选择最高质量可用图片，优先 UHD，其余按像素总数选择；1080x1920 为竖屏。指定尺寸不可用时返回错误","example":"UHD"},"required":false,"description":"省略时选择最高质量可用图片，优先 UHD，其余按像素总数选择；1080x1920 为竖屏。指定尺寸不可用时返回错误","name":"resolution","in":"query"}],"responses":{"200":{"description":"Bing 当前日图 JPEG 原始内容，默认最高质量可用版本，优先 UHD，支持 resolution 指定尺寸，上限 64 MiB；响应公开缓存最长 300 秒并受快照有效期约束","headers":{"Content-Length":{"description":"实际 JPEG 响应体字节数","schema":{"type":"string"}},"Content-Disposition":{"description":"inline 图片文件名","schema":{"type":"string"}},"ETag":{"description":"上游提供的图片实体标识，存在时返回","schema":{"type":"string"}},"Last-Modified":{"description":"上游提供的图片最后修改时间，存在时返回","schema":{"type":"string"}},"X-Bing-Market":{"description":"日图地区","schema":{"type":"string"}},"X-Bing-Date":{"description":"日图起始日期，YYYY-MM-DD","schema":{"type":"string"}},"X-Bing-End-Date":{"description":"日图结束日期，YYYY-MM-DD","schema":{"type":"string"}},"X-Bing-Resolution":{"description":"实际返回的分辨率选项","schema":{"type":"string"}},"X-Bing-Width":{"description":"实际图片宽度，像素","schema":{"type":"string"}},"X-Bing-Height":{"description":"实际图片高度，像素","schema":{"type":"string"}},"X-Bing-Image-URL":{"description":"Bing 原始图片 URL","schema":{"type":"string"}},"X-Bing-Title":{"description":"UTF-8 百分号编码的标题，使用 decodeURIComponent 解码","schema":{"type":"string"}},"X-Bing-Copyright":{"description":"UTF-8 百分号编码的版权信息，使用 decodeURIComponent 解码","schema":{"type":"string"}},"X-Bing-Copyright-URL":{"description":"图片版权链接","schema":{"type":"string"}},"X-Bing-Info-Updated-At":{"description":"D1 快照成功更新时间，UTC ISO 8601","schema":{"type":"string"}},"X-Bing-Info-Expires-At":{"description":"D1 快照有效期截止时间，UTC ISO 8601","schema":{"type":"string"}}},"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"502":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"504":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/admin/api/me":{"get":{"tags":["管理"],"summary":"验证管理员 Token","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","enum":["admin"]},"alias":{"type":"string"}},"required":["id","alias"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/admin/api/tokens":{"get":{"tags":["管理"],"summary":"列出业务 Token","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":64},"enabled":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rateLimit":{"type":"integer","minimum":1,"maximum":1000000},"id":{"type":"string"},"prefix":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["alias","enabled","expiresAt","rateLimit","id","prefix","createdAt","updatedAt"]}}},"required":["tokens"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"},"post":{"tags":["管理"],"summary":"创建业务 Token","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":64},"enabled":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rateLimit":{"type":"integer","minimum":1,"maximum":1000000}},"required":["alias"]}}}},"responses":{"201":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":64},"enabled":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rateLimit":{"type":"integer","minimum":1,"maximum":1000000},"id":{"type":"string"},"prefix":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"token":{"type":"string"}},"required":["alias","enabled","expiresAt","rateLimit","id","prefix","createdAt","updatedAt","token"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/admin/api/tokens/{id}":{"put":{"tags":["管理"],"summary":"更新业务 Token","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":64},"enabled":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rateLimit":{"type":"integer","minimum":1,"maximum":1000000}},"required":["alias","enabled","expiresAt","rateLimit"]}}}},"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"alias":{"type":"string","minLength":1,"maxLength":64},"enabled":{"type":"boolean"},"expiresAt":{"type":["string","null"],"format":"date-time"},"rateLimit":{"type":"integer","minimum":1,"maximum":1000000},"id":{"type":"string"},"prefix":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["alias","enabled","expiresAt","rateLimit","id","prefix","createdAt","updatedAt"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/token/me":{"get":{"tags":["管理"],"summary":"查看当前 Token 身份","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"alias":{"type":"string"},"rateLimit":{"type":"number"}},"required":["id","alias","rateLimit"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/sharing/usage":{"get":{"tags":["内容分享"],"summary":"查看分享配额与保留规则","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","additionalProperties":{}},"usage":{"type":"array","items":{"type":"object","additionalProperties":{}}},"limits":{"type":"array","items":{"type":"object","additionalProperties":{}}},"states":{"type":"array","items":{"type":"object","additionalProperties":{}}},"observedAt":{"type":"string"}},"required":["settings","usage","limits","states","observedAt"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/short-links":{"post":{"tags":["内容分享"],"summary":"创建短链接","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":4096,"format":"uri"},"expiresAt":{"type":["string","null"],"format":"date-time","description":"省略采用服务端默认有效期（初始30天），最长初始365天；null要求永久分享权限。当前策略见 GET /sharing/usage。"}},"required":["url"]}}}},"responses":{"201":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"},"get":{"tags":["内容分享"],"summary":"列出自己的短链接","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["active","expired","disabled","purged"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"owner","in":"query"}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/pastes":{"post":{"tags":["内容分享"],"summary":"创建纯文本分享","security":[{"bearerAuth":[]}],"description":"content 按 UTF-8 编码最多 65536 字节，保留空格和换行。JSON 请求体最多 512 KiB。\n访问类别：需要 Token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":65536},"expiresAt":{"type":["string","null"],"format":"date-time","description":"省略采用服务端默认有效期（初始30天），最长初始365天；null要求永久分享权限。当前策略见 GET /sharing/usage。"}},"required":["content"]}}}},"responses":{"201":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"tags":["内容分享"],"summary":"列出自己的Pastebin","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["active","expired","disabled","purged"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"owner","in":"query"}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/short-links/{code}":{"delete":{"tags":["内容分享"],"summary":"停用短链接","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"204":{"description":"内容已停用"},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/admin/api/short-links":{"get":{"tags":["管理"],"summary":"列出全部短链接","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["active","expired","disabled","purged"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"owner","in":"query"}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/admin/api/short-links/{code}":{"delete":{"tags":["管理"],"summary":"停用短链接","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"204":{"description":"内容已停用"},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/s/{code}":{"get":{"tags":["内容分享"],"summary":"匿名打开短链接","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"302":{"description":"跳转到目标地址","headers":{"Location":{"schema":{"type":"string"},"description":"目标地址"}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"内容不存在或已失效","content":{"text/plain":{"schema":{"type":"string"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/pastes/{code}":{"delete":{"tags":["内容分享"],"summary":"停用Pastebin","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"204":{"description":"内容已停用"},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：需要 Token"}},"/admin/api/pastes":{"get":{"tags":["管理"],"summary":"列出全部Pastebin","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":512},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["active","expired","disabled","purged"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","maxLength":64},"required":false,"name":"owner","in":"query"}],"responses":{"200":{"description":"处理结果","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"shareUrl":{"type":"string"},"createdAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"disabledAt":{"type":["string","null"]},"purgedAt":{"type":["string","null"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","purgedAt","status"]}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"]}}}},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/admin/api/pastes/{code}":{"delete":{"tags":["管理"],"summary":"停用Pastebin","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"204":{"description":"内容已停用"},"400":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"请求校验或执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：管理员 Token"}},"/p/{code}":{"get":{"tags":["内容分享"],"summary":"匿名读取纯文本","security":[],"parameters":[{"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{12}$"},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"UTF-8 原文","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"内容不存在或已失效","content":{"text/plain":{"schema":{"type":"string"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/openapi.json":{"get":{"tags":["项目信息"],"summary":"获取 OpenAPI 文档","responses":{"200":{"description":"OpenAPI 3.1 文档","content":{"application/json":{"schema":{"type":"object","properties":{"openapi":{"type":"string"},"info":{"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string"}},"required":["title","version"],"additionalProperties":{}},"paths":{"type":"object","additionalProperties":{}}},"required":["openapi","info","paths"],"additionalProperties":{}}}}},"400":{"description":"参数或请求格式无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"凭据无效、停用、过期或缺少所需 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"需要管理员 Token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"请求体过大","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"请求内容类型无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"触发请求限流时建议等待的秒数","schema":{"type":"integer","example":60}}}},"500":{"description":"内部执行失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"FormatData":{"name":"_format","in":"query","required":false,"description":"响应格式为 json 或 text；_format=svg 返回 JSON。plain 是 text 的别名。未识别的值继续按 Accept 协商。","schema":{"type":"string","enum":["json","text"]}},"FormatImage":{"name":"_format","in":"query","required":false,"description":"响应格式为 svg、json 或 text。/color/{hex} 默认 JSON，带 curl* 标记的接口默认 SVG。plain 是 text 的别名。未识别的值继续按 Accept 协商。","schema":{"type":"string","enum":["svg","json","text"]}},"Color":{"name":"_color","in":"query","required":false,"description":"控制 text 响应的 ANSI 颜色。0、false、off、no 关闭；省略或其他值保留。","schema":{"type":"string","enum":["0","false","off","no"]}}},"schemas":{"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"location":{"type":"string","enum":["body","query","path","header"]},"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["location","field","code","message"]}}},"required":["code","message"]}},"required":["error"]}}},"webhooks":{},"tags":[{"name":"编码转换"},{"name":"摘要计算"},{"name":"JWT 解析"},{"name":"时间与计划"},{"name":"随机数据"},{"name":"数学求解"},{"name":"网络查询"},{"name":"请求与设备信息"},{"name":"HTTP 调试"},{"name":"趣味工具"},{"name":"内容分享"},{"name":"Minecraft"},{"name":"Bing 壁纸"},{"name":"管理"},{"name":"项目信息"}]}