缓存预热接口
更新时间：2025-12-11
接口
本接口用于预先将资源缓存到 GEO，支持批量提交，一次最多提交1000个 url 预热请求。您可以根据您购买的 GEO 套餐，知晓您 24 小时之内最多提交 url 预热请求的额度。
请求接口
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/geo/cache/prefetch | 缓存预热接口 |
请求体
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| tasks | PrefetchTask[] | 必选 | 提交的预热任务列表详情。 |
| site | String | 必选 | 提交预热任务的站点。 |
PrefetchTask 类型如下：
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| url | String | 必选 | 表示需要预热的 url。 |
响应码
| HTTP Status Code | 说明 |
|---|---|
| 201 | 预热接口下发成功 |
| 其他错误码 | 额度不足、参数错误、用户操作错误等 |
响应体
| 参数 | 类型 | 说明 |
|---|---|---|
| id | String | 提交预热任务后生成的 id，可用于查询任务状态。 |
请求示例
Plain Text
1POST /v2/geo/cache/prefetch HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json
5Accept-Encoding: gzip
6
7{
8 "tasks": [
9 {
10 "url": "http://1.test.com/test1.png"
11 },
12 {
13 "url": "http://1.test.com/test2.png"
14 }
15 ],
16 "site": "modao.cc"
17}响应示例
Plain Text
1HTTP/1.1 201 OK
2Server: nginx/1.16.1
3Content-Type: application/json; charset=utf-8
4Transfer-Encoding: chunked
5Connection: keep-alive
6
7{
8 "id": "xxx"
9}评价此篇文章