← Images / images / storage / upload-images

Nahrání přes URL

Než obrázek nahrajete, zkontrolujte seznam podporované formáty a rozměry k potvrzení, že váš obrázek bude přijat.

Pomocí Images API můžete místo nahrávání dat obrázku zadat jeho URL.

Vytvořte POST podle příkladu níže. Mějte na paměti, že --form 'file=<FILE>' a --form 'url=<URL>' pole se vzájemně vylučují.

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'

Po úspěšném nahrání obrázku obdržíte odpověď podobnou následujícímu příkladu.

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

Pokud váš origin server při načítání obrázků vrátí chybu, odpověď API vrátí chybu 4xx.