Cloud Storage
Microsoft Azure Blob Storage
To allow our servers to save files on a Microsoft Azure Blob Storage, the following parameters to send the request are available:
Field | Description | Required | Default |
---|---|---|---|
output_target.type | Specifies the type of output target, in this case azure. | Yes | N/A |
output_target.parameters.container | The name of the container that will contain the uploaded files. | Yes | N/A |
output_target.parameters.file | Complete path to where the file will be uploaded, e.g. folder-inside-container/image.jpeg .
|
Yes | N/A |
output_target.credentials.accountname | Can be found in the storage account dashboard. It's the name
before the blob.core.windows.net URL.
|
Yes | N/A |
output_target.credentials.accountkey | Can be found in the storage account dashboard under the Access Keys menu entry. | Yes | N/A |
Please note that in some circumstances (e.g. already existing filename on the cloud) the upload can be refused. For these reasons, it's highly recommended to upload converted files in new directories.
POST /v2/jobs HTTP/1.1
Host: api.api2convert.com
x-oc-api-key: <your API key here>
Content-Type: application/json
Cache-Control: no-cache
{
"input": [{
"type": "remote",
"source": "https://example-files.online-convert.com/raster%20image/jpg/example_small.jpg"
}],
"conversion": [{
"target": "png",
"output_target": [{
"type": "azure",
"parameters": {
"container": "the name of your container",
"file": "file-will-be-uploaded/here.png"
},
"credentials": {
"accountname": "your account name",
"accountkey": "your account key"
}
}]
}]
}
curl -X POST \
https://api.api2convert.com/v2/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://example-files.online-convert.com/raster%20image/jpg/example_small.jpg"
}],
"conversion": [{
"target": "png",
"output_target": [{
"type": "azure",
"parameters": {
"container": "the name of your container",
"file": "file-will-be-uploaded/here.png"
},
"credentials": {
"accountname": "your account name",
"accountkey": "your account key"
}
}]
}]
}'