バッチAPIを介してアップロード
ImagesバッチAPIを使用すると、CloudflareのグローバルAPIレート制限を回避しながら、いくつかのリクエストを順番に行うことができます。
ImagesバッチAPIを使用するには、バッチトークンを取得し、そのトークンを使用していくつかのリクエストを行う必要があります。このバッチトークンによって承認されたリクエストは、別のエンドポイントに送信され、グローバルAPIレート制限にはカウントされません。各トークンは、1秒あたり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>"
# レスポンス:{ "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
これらのオプションは、異なるホストと異なるパスを使用し、同じメソッド、リクエスト、およびレスポンスボディを持っています。
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v2" \--header "Authorization: Bearer <API_TOKEN>"curl "https://batch.imagedelivery.net/images/v2" \--header "Authorization: Bearer <BATCH_TOKEN>"