You can now be fully in charge of your own file storage within Doc Conversion API our new Linked Storage feature, supporting Amazon S3 and Azure Storage.
By default, at Doc Conversion Api we store files in our secure cloud servers, however, if you already have a cloud storage solution in place and you would like to integrate it with Doc Conversion API, you can now easily do that.
You no longer need to send your files to our servers, everything can be done using your own storage resources. You are now able to import files from your cloud storage, convert, process, or merge these files, and export them back to your cloud storage, without having to use our servers, that way you ensure that the whole process is compatible with your internal security standards.
Our Linked Storage feature will allow you to add more than one service, and simultaneously switch between them in a simple, efficient way. You can also manage your linked storage accounts at any time; edit, rename, and delete accounts easily through your dashboard.
Doc Conversion API currently supports the two main cloud storage providers, Amazon S3 and Azure Storage.
Adding Linked Storage Accounts:
Amazon S3:
You can easily configure your S3 bucket as a storage backend by providing your Amazon key ID, key secret, and bucket name. Once you have these details, adding your account is as simple as a few steps.
1. Click on “Add New Storage Account”
2. Select “Amazon”
3. Fill in your details.
4. Click on “Add Account” to finish.
Azure:
Similarly, adding an Azure container can be easily done from the “Linked Storage” section in your dashboard. You just need your Azure account name, account key and container name.
You can read here about how to obtain your Azure storage credentials. Once you have your credentials ready, adding your account is super simple.
1. Click on “Add New Storage Account”.
2. Select “Azure”
3. Fill in your details
4. Click on “Add Account” to finish.
Using Linked Storage Accounts:
Our aim is to make it easier for you to read, convert, and write files, using our REST API, you can now do all of the above with a few simple lines of code.
Import files:
To import the files you would like to convert from your storage service, you simply need to add a parameter to the body of your HTTP request, this is named “inputFile”, and should be assigned the following value:
storage://Local_account_name/bucket_name/FilePath
Local_account_name: is the custom name of the your storage account in your dashboard.
Bucket_name: is the name of your bucket or blob.
FilePath: is the path of the file you’d like to import.
Export files:
After converting your files, you can save them directly into your storage service, this can be done by adding a field called “saveTo”, and assigning the following value to it.
<code>storage://Local_account_name/bucket_name/FilePath+Name</code>
Local_account_name: is the custom name of the your storage account in your dashboard.
Bucket_name: is the name of your bucket or blob.
FilePath+Name: This is the path where you would you like to save the converted file, along with the file name.
If you need any further help with setting up your storage services, please email us on [email protected], and we will be happy to help.
