刷新预热

参考接口说明中的“调用频率限制”。

API

额度

查询额度

PATH: /refreshpreload/quota/v1/quota

Method: GET

参数：无

{
  "data": {
    "dayRefreshUrlQuota": 100,
    "dayRefreshDirQuota": 100,
    "dayPreloadQuota": 100,
    "dayRefreshUrlSurplus": 100,
    "dayRefreshDirSurplus": 100,
    "dayPreloadSurplus": 100
  },
  "reqId": "1234567890"
}

字段	类型	含义
dayRefreshUrlQuota	number	每日刷新 URL 限额
dayRefreshDirQuota	number	每日刷新目录限额
dayPreloadQuota	number	每日预热 URL 限额
dayRefreshUrlSurplus	number	每天的刷新 URL 次数余额
dayRefreshDirSurplus	number	每天的目录刷新次数余额
dayPreloadSurplus	number	每天的预取次数余额

刷新&预热

创建限制

URL 刷新接口 /refreshpreload/refresh/v1/create 与 URL 预热接口 /refreshpreload/preload/v1/create 提交的 URL 总量按秒合并统计，每秒不超过 180 条。
单次请求限制：URL 刷新和 URL 预热每次请求最多提交 50 条 URL，目录刷新每次请求最多提交 10 条目录。

刷新

PATH: /refreshpreload/refresh/v1/create

Method: POST

参数：

{
  "urls": ["http://example.com"]
}

或者目录刷新：

{
  "dirs": ["http://example.com/"]
}

参数说明：

字段	类型	含义
urls	array	URL 列表，每次最多提交 50 条，同时受刷新 URL + 预热 URL 每秒总量不超过 180 条的共享限制约束
dirs	array	目录列表，每次最多提交 10 条

每条 URL 要以 http:// 或 https:// 开头，目录刷新要以 / 结尾。

{
  "data": {
    "taskId": "1234567890"
  },
  "reqId": "1234567890"
}

字段	类型	含义
taskId	string	任务 ID，用于后续查询任务状态

预热

PATH: /refreshpreload/preload/v1/create

Method: POST

参数：

{"urls": ["http://example.com"]}

参数说明：

字段	类型	含义
urls	array	URL 列表，每次最多提交 50 条，同时受刷新 URL + 预热 URL 每秒总量不超过 180 条的共享限制约束

{"data": {"taskId": "1234567890"},"reqId": "1234567890"}

字段	类型	含义
taskId	string	任务 ID，用于后续查询任务状态

⚠️ 查询任务状态（已废弃）

该接口已废弃，建议使用下方“查询任务状态V2”接口。

PATH: /refreshpreload/search/v1/tasks

Method: GET

注意：只支持查询最近 3 天的数据。

参数：

{"type": "file","page": 1,"size": 100,"taskId": "1234567890"}

参数说明：

字段	类型	是否必传	含义
page	number	是	页码，从 1 开始
size	number	是	每页大小，最大 100
type	string	是	任务类型，值：file、dir、preload
taskId	string	否	任务 ID

{
  "data": {
    "tasks": [
      {
        "taskId": "1234567890",
        "type": "file",
        "status": "processing",
        "resource": "http://example.com",
        "process": "0%",
        "domain": "example.com",
        "createTime": 1633072800,
        "updateTime": 1633072800
      }
    ],
    "total": 1
  },
  "reqId": "1234567890"
}

字段	类型	含义
tasks	array	task 列表，参见文档最后 task 字段说明
total	number	总数

查询任务状态V2

PATH: /refreshpreload/search/v2/tasks

Method: GET

注意：只支持查询最近 3 天的数据。

参数：

{"type": "file", "taskId": "1234567890"}

参数说明：

字段	类型	是否必传	含义
type	string	是	任务类型，值：file、dir、preload
taskId	string	是	任务 ID

{
  "data": {
    "tasks": [
      {
        "taskId": "1234567890",
        "type": "file",
        "status": "processing",
        "resource": "http://example.com",
        "process": "0%",
        "domain": "example.com",
        "createTime": 1633072800,
        "updateTime": 1633072800
      }
    ]
  },
  "reqId": "1234567890"
}

字段	类型	含义
tasks	array	task 列表，参见文档最后 task 字段说明

task 字段说明：

字段	类型	含义
taskId	string	任务 ID
type	string	任务类型，可能的值：file、dir、preload
status	string	任务状态，可能的值：processing、completed、failed
resource	string	任务资源，提交的刷新或者预热的 URL
process	string	任务进度，0% ~ 100%
domain	string	任务域名
createTime	number	创建时间，unix 时间戳，精确到秒
updateTime	number	更新时间，unix 时间戳，精确到秒

刷新预热

说明

鉴权

接口响应

QPS

API

额度

查询额度

刷新&预热

创建限制

刷新

预热

⚠️ 查询任务状态（已废弃）

查询任务状态V2

On this page