Cloud Storage

FTP Server

To allow our servers to upload files directly to an FTP server, the following parameters to send the request are available:

FieldDescriptionRequiredDefault
output_target.typeSpecifies the type of output target, in this case ftp.YesN/A
output_target.parameters.hostThe URL or IP of the FTP server.YesN/A
output_target.parameters.fileComplete path to where the file will be uploaded, e.g. folder-in-ftp/image.jpeg.YesN/A
output_target.parameters.portThe port used to connect to the FTP server.No21
output_target.credentials.usernameThe username of the FTP server account.YesN/A
output_target.credentials.passwordThe password of the FTP server account.YesN/A

Please note that in some circumstances (e.g. already existing filename on the server) the upload can be refused. For these reasons, it's highly recommended to upload converted files in new directories.

POST /jobs HTTP/1.1
Host: api2.online-convert.com
x-oc-api-key: <your API key here>
Content-Type: application/json
Cache-Control: no-cache

{
    "input": [{
        "type": "remote",
        "source": "https://static.online-convert.com/example-file/raster%20image/jpg/example_small.jpg"
    }],
    "conversion": [{
        "target": "png",
        "output_target": [{
            "type": "ftp",
            "parameters": {
                "host": "your ftp server host",
                "file": "file-will-be-saved/here.png"
            },
            "credentials": {
                "username": "your ftp server username",
                "password": "your ftp server password"
            }
        }]
    }]
}
curl -X POST \
  https://api2.online-convert.com/jobs \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'x-oc-api-key: <your API key here>' \
  -d '{
    "input": [{
        "type": "remote",
        "source": "https://static.online-convert.com/example-file/raster%20image/jpg/example_small.jpg"
    }],
    "conversion": [{
        "target": "png",
        "output_target": [{
            "type": "ftp",
            "parameters": {
                "host": "your ftp server host",
                "file": "file-will-be-saved/here.png"
            },
            "credentials": {
                "username": "your ftp server username",
                "password": "your ftp server password"
            }
        }]
    }]
}'

results matching ""

    No results matching ""