Cloudflare Images が自動生成する UUID（Universally Unique Identifier）のパスではなく、カスタム ID パスを使って画像をアップロードできます。
カスタムパスは次をサポートします。
- 最大 1,024 文字。
- 任意の数のサブパス。
- 文字の UTF-8 エンコーディング ↗。
次の例を参考に POST リクエストを送ります。URL 経由のアップロードでも、ファイルの直接アップロードでも、カスタム ID パスを使えます。
curl --request POST https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 \
--header "Authorization: Bearer <API_TOKEN>" \
--form 'url=https://<REMOTE_PATH_TO_IMAGE>' \
--form 'id=<PATH_TO_YOUR_IMAGE>'アップロードが成功すると、次のようなレスポンスが返ります。
{
"result": {
"id": "<PATH_TO_YOUR_IMAGE>",
"filename": "<YOUR_IMAGE>",
"uploaded": "2022-04-20T09:51:09.559Z",
"requireSignedURLs": false,
"variants": [
"https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/<PATH_TO_YOUR_IMAGE>/public"
]
},
"result_info": null,
"success": true,
"errors": [],
"messages": []
}