URL からアップロードする

画像をアップロードする前に、対応形式とサイズを確認し、画像が受け入れられることを確かめてください。

Images API を使うと、画像データをアップロードする代わりに、画像の URL を指定できます。

次の例を参考に POST リクエストを送ります。--form 'file=<FILE>' と --form 'url=<URL>' は同時に使えません。

curl --request POST \
https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 \
--header "Authorization: Bearer <API_TOKEN>" \
--form 'url=https://[user:password@]example.com/<PATH_TO_IMAGE>' \
--form 'metadata={"key":"value"}' \
--form 'requireSignedURLs=false'

アップロードが成功すると、次のようなレスポンスが返ります。

{
	"result": {
		"id": "2cdc28f0-017a-49c4-9ed7-87056c83901",
		"filename": "image.jpeg",
		"metadata": {
			"key": "value"
		},
		"uploaded": "2022-01-31T16:39:28.458Z",
		"requireSignedURLs": false,
		"variants": [
			"https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/2cdc28f0-017a-49c4-9ed7-87056c83901/public",
			"https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/2cdc28f0-017a-49c4-9ed7-87056c83901/thumbnail"
		]
	},
	"success": true,
	"errors": [],
	"messages": []
}

オリジンサーバーが画像の取得中にエラーを返すと、API レスポンスは 4xx エラーになります。