← Images / images / storage / upload-images

Nahrát přes dávkové API

Dávkové Images API umožňuje odesílat několik požadavků za sebou a přitom obejít globální limity četnosti požadavků Cloudflare API.

Chcete-li používat dávkové API služby Images (batch API), budete si muset opatřit dávkový token a pomocí něj odesílat jednotlivé požadavky. Požadavky autorizované tímto tokenem míří na samostatný endpoint a nezapočítávají se do globálních limitů API. Pro každý token platí limit 200 požadavků za sekundu. Pokud potřebujete vyšší propustnost k Cloudflare Images API, můžete použít více tokenů.

Chcete-li získat token, můžete použít nový images/v1/batch_token koncový bod, jak je uvedeno v příkladu níže.

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": []
}

Jakmile token získáte, použijte ho k odesílání požadavků na:

Nahrát obrázek - POST /images/v1
Odstranění obrázku - DELETE /images/v1/{identifier}
Podrobnosti o obrázku - GET /images/v1/{identifier}
Aktualizovat obrázek - PATCH /images/v1/{identifier}
Seznam obrázků V2 - GET /images/v2
Direct upload V2 - POST /images/v2/direct_upload

Tyto možnosti používají jiného hostitele a jinou cestu se stejnou metodou, požadavkem a těly odpovědí.

Požadavek na seznam obrázků V2 vůči api.cloudflare.com

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v2" \
--header "Authorization: Bearer <API_TOKEN>"

Příklad požadavku s použitím dávkového tokenu

curl "https://batch.imagedelivery.net/images/v1" \
--header "Authorization: Bearer <BATCH_TOKEN>"