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エラーを返します。