版本 2.1.1792967583 · 最新 下载 OpenAPI Markdown 版

刷新与预热

刷新(清除)缓存的 URL 或目录,以及预热指定 URL。

cache-jobs缓存鉴权: 用户（部分参数仅管理员）3 个接口

列出刷新/预热任务

GET/api/v2/cache-jobs
鉴权: 用户（部分参数仅管理员）

查询参数

字段类型必填说明
pageinteger— 页码,从 1 开始。
默认 1
page_sizeinteger— 每页条数。
默认 20
sortstring— 排序字段,逗号分隔,前缀 `-` 表示降序,如 `-created_at,id`。
tenant_idinteger— 仅管理员可用:按租户过滤。租户凭据调用时忽略,只返回本租户数据。
typestring— 只列该类型的任务。
可选值 ["purge_url","purge_dir","prefetch"]
urlstring— 以 http:// 或 https:// 开头时按完整 URL(同提交时规范化)精确匹配(任务的 URL 列表里含它);否则按主机名精确匹配。

创建刷新/预热任务

POST/api/v2/cache-jobs
鉴权: 用户（部分参数仅管理员）

请求体 application/json

字段类型必填说明
typestring必填 purge_url 刷新 URL;purge_dir 刷新目录(URL 以 / 结尾);prefetch 预热。
可选值 ["purge_url","purge_dir","prefetch"]
urlsstring[]必填 http(s)://主机/路径(规范化后,见创建接口);预热一次最多 100 条。

获取刷新/预热任务

GET/api/v2/cache-jobs/{id}
鉴权: 用户（部分参数仅管理员）

刷新与预热对象

字段类型必填说明
created_atstring— 创建时间
只读
idinteger— 记录 ID
只读
resultsCacheJobNodeResult[]— 各节点的执行结果(只在详情里回)。
只读
site_idinteger— 网站 ID
只读
statusstring— 下发任务的状态(有节点失败时 pending 退避重试,次数用完 failed)。
只读可选值 ["pending","running","done","failed"]
tenant_idinteger— 所属租户(用户)ID
只读
typestring— purge_url 刷新 URL;purge_dir 刷新目录(URL 以 / 结尾);prefetch 预热。
可选值 ["purge_url","purge_dir","prefetch"]
updated_atstring— 更新时间
只读
urlsstring[]— http(s)://主机/路径(规范化后,见创建接口);预热一次最多 100 条。