{"openapi":"3.1.0","info":{"title":"simpleWebUtilsServerless","version":"0.1.0+git.e49364dc2d25","description":"HTTP 工具 API。接口访问类别和 Bearer 认证要求见各操作说明。短链接与 Pastebin 的创建和管理要求 Token，分享地址允许匿名访问。业务接口支持跨域无凭据调用，并可提供 Authorization Token。匿名请求按 IP 使用每分钟约 120 次普通额度、30 次网络额度和 10 次计算额度；Token 请求按身份使用 D1 原子计数，普通额度独立配置，资源额度分别为 30 和 10。认证查询另有来源保护。鉴权及普通额度检查先于缓存，缓存未命中时检查资源额度。Minecraft 玩家与图片缓存 300 秒、服务端状态缓存 30 秒、种子结果缓存 3600 秒；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 位小写十六进制摘要"},"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 位小写十六进制摘要"}},"required":["md5","sha1","sha256","sha512","sha3_256","sha3_512"]}}}},"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 位小写十六进制摘要"},"sha512":{"type":"string","minLength":128,"maxLength":128,"pattern":"^[0-9a-f]+$","description":"128 位小写十六进制摘要"}},"required":["md5","sha1","sha256","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 使用独立额度"}},"/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 使用独立额度"}},"/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"}}}}},"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"}}}}},"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"}}}}},"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"}}}}},"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"}}}}},"description":"访问类别：匿名 API，可携带 Token 使用独立额度"}},"/visitor":{"get":{"tags":["请求与设备信息"],"summary":"查看访问者与 Cloudflare 连接信息","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},"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 声明"}},"required":["ip","source","country","city","continent","region","regionCode","postalCode","timezone","latitude","longitude","asOrganization","asn","colo","cfRay","httpProtocol","tlsVersion","tlsCipher","clientTcpRtt","clientQuicRtt","edgeL4","clientAcceptEncoding"]}}}},"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 使用独立额度"}},"/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 使用独立额度"}},"/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"]},"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","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 使用独立额度"}},"/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"},"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"}},"/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"}},"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}],"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}},"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}],"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}}}},"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"}],"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}}}},"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"}}}},"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"}],"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"]},"status":{"type":"string","enum":["active","expired","disabled"]},"url":{"type":"string"},"bytes":{"type":"integer"},"ownerId":{"type":"string"}},"required":["code","shareUrl","createdAt","expiresAt","disabledAt","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"}}}},"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"}}}},"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"}},"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"]}},"parameters":{}},"webhooks":{},"tags":[{"name":"编码转换"},{"name":"摘要计算"},{"name":"JWT 解析"},{"name":"时间与计划"},{"name":"随机数据"},{"name":"数学求解"},{"name":"网络查询"},{"name":"请求与设备信息"},{"name":"HTTP 调试"},{"name":"内容分享"},{"name":"Minecraft"},{"name":"Bing 壁纸"},{"name":"管理"},{"name":"项目信息"}]}