← Images / images / storage / upload-images

Загрузка через пакетный API

Пакетный API Images (batch API) позволяет выполнять несколько запросов подряд в обход глобальных ограничений частоты запросов API Cloudflare.

Чтобы использовать batch API Images, необходимо получить batch-токен и использовать его для выполнения нескольких запросов. Запросы, авторизованные этим batch-токеном, отправляются на отдельный endpoint и не учитываются в глобальных ограничениях частоты запросов API. Для каждого токена действует ограничение в 200 запросов в секунду. Чтобы повысить пропускную способность при обращении к Cloudflare Images API, можно использовать несколько токенов.

Чтобы получить токен, можно использовать новый 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": []
}

Получив токен, используйте его для выполнения запросов к:

Загрузить изображение - 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

Эти параметры используют другой хост и другой путь с теми же методом, телом запроса и телом ответа.

Запрос списка изображений V2 к api.cloudflare.com

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>"