Images batch API 让您进行多个顺序请求,同时绕过 Cloudflare 的全局 API 速率限制。
要使用 Images batch API,您需要获取 batch token 并使用该 token 进行多个请求。由此 batch token 授权的请求发送到单独的端点,不计入全局 API 速率限制。每个 token 的速率限制为每秒 200 个请求。如果需要更高的 Cloudflare Images API 吞吐量,可以使用多个 token。
要获取 token,您可以使用如下示例所示的新 images/v1/batch_token 端点。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/batch_token" \
--header "Authorization: Bearer <API_TOKEN>"
# Response:
{
"result": {
"token": "<BATCH_TOKEN>",
"expiresAt": "2023-08-09T15:33:56.273411222Z"
},
"success": true,
"errors": [],
"messages": []
}获取 token 后,使用它进行以下请求:
- 上传图像 -
POST /images/v1 - 删除图像 -
DELETE /images/v1/{identifier} - 图像详情 -
GET /images/v1/{identifier} - 更新图像 -
PATCH /images/v1/{identifier} - 列出图像 V2 -
GET /images/v2 - 直接上传 V2 -
POST /images/v2/direct_upload
这些选项使用不同的主机和路径,但方法、请求和响应体相同。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v2" \
--header "Authorization: Bearer <API_TOKEN>"curl "https://batch.imagedelivery.net/images/v1" \
--header "Authorization: Bearer <BATCH_TOKEN>"