About this API
VaultasticActiveStoreMailUpload API is used to upload mails with varying sizes, faster uploads, and processing. It is a two-part call to upload mail to VaultasticActiveStoreMailUpload API.
Resources
To build an SDK using the API in a language of your choice refer to this document.
Calling the APIs
1. Send the initial request to get a pre-signed URL:
To initiate an upload, use https://vaultasticactivestoremailuploadapi.vaultastic.com URL with the POST method.
Create a POST request to the upload URI:
Method:
POST https://vaultasticactivestoremailuploadapi.vaultastic.com
Headers:
1. x-api-key: <Api Key provided>
2. User-Agent: <SDK Version>
Success Response:
If the initiation request succeeds, the response includes a 200 OK HTTP status code.
In addition, it includes an Pre-Signed URL and fields in the JSON response data:
{
"url": "https://ind1-mithi-vv4-dc1-api-temp-mailstorage-s3.s3.amazonaws.com/",
"fields": {
"key": "w38q5qwhgj/2021/02/02/11/2971ddb3-1058-4af9-ba9d-c925e51afca7.eml",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-credential": "ASIAUFC44OICB6OIONNC/20210202/ap-south-1/s3/aws4_request",
"x-amz-date": "20210202T112803Z",
"x-amz-security-token": "IQoJb3JpZ2luX2VjEOv//////////wEaCmFwLXNvdXRoLTEiSDBGAiEAo6Vt4YvJBO4T90tZL9Z8yXSIASgbNPV5Gr4jWxCWxgACIQCclEkEEREHrMDGbbvpQZ2dX4jyl4StVQdq/6ImmUGJxyr3AQjU//////////8BEAAaDDI4NTgxMDEyNzM2NCIMCww6OI2v6F0v8SqXKssBepPo/AbxdGtF3H5i0SPS1WxnJO217VfzZaSC8ewN61vEvs1rh6qOvVkAthlU1gWqObSYKHRq2XsVy+/Qhrv6wY/o8Ln24gnukstsBLdxHYIAdJAgNYj21R3HYRvmhTqyMrKrXcjo1MpMPMFrx1lvhVWqhyoSQn1pjT68tn+ezaNLBMNCvn8NwvTbj++pTUnunnk54tQ3rdIF9Fwzp+xNka5bOtx+CA5qDAtaqm62vYTHH41CvtBgnZOhSUhkdTgL2spHpz53Jvk/UkIwjtvkgAY63wGyzbT1NywqZfQDlFdZivlsB1BBBbQwBFJDAecYXyHfXyXjPe43vHfhA15a1w/70xVUs0Aj+PPvA0pLo8RBhSuB3oEx4aMuDXluIqKpum9h/gbjlddkujDM/avDPxNabCTRFybgqB4k+ogHdAGN9EOs2ZR0kf0bjnVCDpxUicIncR3RHTlnMk5EzBHS5qIwh96Sb2LYQfUFhTXoJnmeDLH+Fe7h13tQZYs6YTRO10VbH5TNwu6x0EgSzmodYWWhdwCjhcJw/98EKfHUf3Z1Ia8ZlPW/F1GZfbd6laGpanE9",
"policy": "eyJleHBpcmF0aW9uIjogIjIwMjEtMDItMDJUMTE6MzM6MDNaIiwgImNvbmRpdGlvbnMiOiBbeyJidWNrZXQiOiAiaW5kMS1taXRoaS12djQtZGMxLWFwaS10ZW1wLW1haWxzdG9yYWdlLXMzIn0sIHsia2V5IjogInczOHE1cXdoZ2ovMjAyMS8wMi8wMi8xMS8yOTcxZGRiMy0xMDU4LTRhZjktYmE5ZC1jOTI1ZTUxYWZjYTcuZW1sIn0sIHsieC1hbXotYWxnb3JpdGhtIjogIkFXUzQtSE1BQy1TSEEyNTYifSwgeyJ4LWFtei1jcmVkZW50aWFsIjogIkFTSUFVRkM0NE9JQ0I2T0lPTk5DLzIwMjEwMjAyL2FwLXNvdXRoLTEvczMvYXdzNF9yZXF1ZXN0In0sIHsieC1hbXotZGF0ZSI6ICIyMDIxMDIwMlQxMTI4MDNaIn0sIHsieC1hbXotc2VjdXJpdHktdG9rZW4iOiAiSVFvSmIzSnBaMmx1WDJWakVPdi8vLy8vLy8vLy93RWFDbUZ3TFhOdmRYUm9MVEVpU0RCR0FpRUFvNlZ0NFl2SkJPNFQ5MHRaTDlaOHlYU0lBU2diTlBWNUdyNGpXeENXeGdBQ0lRQ2NsRWtFRVJFSHJNREdiYnZwUVoyZFg0anlsNFN0VlFkcS82SW1tVUdKeHlyM0FRalUvLy8vLy8vLy8vOEJFQUFhRERJNE5UZ3hNREV5TnpNMk5DSU1Dd3c2T0kydjZGMHY4U3FYS3NzQmVwUG8vQWJ4ZEd0RjNINWkwU1BTMVd4bkpPMjE3VmZ6WmFTQzhld042MXZFdnMxcmg2cU92VmtBdGhsVTFnV3FPYlNZS0hScTJYc1Z5Ky9RaHJ2NndZL284TG4yNGdudWtzdHNCTGR4SFlJQWRKQWdOWWoyMVIzSFlSdm1oVHF5TXJLclhjam8xTXBNUE1GcngxbHZoVldxaHlvU1FuMXBqVDY4dG4rZXphTkxCTU5Ddm44Tnd2VGJqKytwVFVudW5uazU0dFEzcmRJRjlGd3pwK3hOa2E1Yk90eCtDQTVxREF0YXFtNjJ2WVRISDQxQ3Z0QmduWk9oU1Voa2RUZ0wyc3BIcHo1M0p2ay9Va0l3anR2a2dBWTYzd0d5emJUMU55d3FaZlFEbEZkWml2bHNCMUJCQmJRd0JGSkRBZWNZWHlIZlh5WGpQZTQzdkhmaEExNWExdy83MHhWVXMwQWorUFB2QTBwTG84UkJoU3VCM29FeDRhTXVEWGx1SXFLcHVtOWgvZ2JqbGRka3VqRE0vYXZEUHhOYWJDVFJGeWJncUI0aytvZ0hkQUdOOUVPczJaUjBrZjBiam5WQ0RweFVpY0luY1IzUkhUbG5NazVFekJIUzVxSXdoOTZTYjJMWVFmVUZoVFhvSm5tZURMSCtGZTdoMTN0UVpZczZZVFJPMTBWYkg1VE53dTZ4MEVnU3ptb2RZV1doZHdDamhjSncvOThFS2ZIVWYzWjFJYThabFBXL0YxR1pmYmQ2bGFHcGFuRTkifV19",
"x-amz-signature": "cf60309b5a07cf78ff6c15f54d34e1ca6a4631773d13a97699c5fb8e1659fde7"
}
}
You should save the Pre-Signed URL so you can upload the file data. A Pre-Signed URL expires after 5 Minutes.
Error Response:
If the required header of x-api-key is not provided:
HTTP Status : 403
{
"message": "Forbidden"
}
2. Second request to upload the content:
Create a processed mail using VaultasticActiveStoreMailUpload API-SDK and upload to Pre-Signed URL from Initial Request.
Create a POST request to the Pre-Signed URL:
Method:
POST <pre-signed URL from response of Initial Request>
Payload:
Create a payload of type form-data with keys and value extracted from Response JSON "fields" from Initial Request and append another key file with processed mail as value.
Example:
"key": "w38q5qwhgj/2021/02/02/11/2971ddb3-1058-4af9-ba9d-c925e51afca7.eml",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-credential": "ASIAUFC44OICB6OIONNC/20210202/ap-south-1/s3/aws4_request",
"x-amz-date": "20210202T112803Z",
"x-amz-security-token": "IQoJb3JpZ2luX2VjEOv//////////wEaCmFwLXNvdXRoLTEiSDBGAiEAo6Vt4YvJBO4T90tZL9Z8yXSIASgbNPV5Gr4jWxCWxgACIQCclEkEEREHrMDGbbvpQZ2dX4jyl4StVQdq/6ImmUGJxyr3AQjU//////////8BEAAaDDI4NTgxMDEyNzM2NCIMCww6OI2v6F0v8SqXKssBepPo/AbxdGtF3H5i0SPS1WxnJO217VfzZaSC8ewN61vEvs1rh6qOvVkAthlU1gWqObSYKHRq2XsVy+/Qhrv6wY/o8Ln24gnukstsBLdxHYIAdJAgNYj21R3HYRvmhTqyMrKrXcjo1MpMPMFrx1lvhVWqhyoSQn1pjT68tn+ezaNLBMNCvn8NwvTbj++pTUnunnk54tQ3rdIF9Fwzp+xNka5bOtx+CA5qDAtaqm62vYTHH41CvtBgnZOhSUhkdTgL2spHpz53Jvk/UkIwjtvkgAY63wGyzbT1NywqZfQDlFdZivlsB1BBBbQwBFJDAecYXyHfXyXjPe43vHfhA15a1w/70xVUs0Aj+PPvA0pLo8RBhSuB3oEx4aMuDXluIqKpum9h/gbjlddkujDM/avDPxNabCTRFybgqB4k+ogHdAGN9EOs2ZR0kf0bjnVCDpxUicIncR3RHTlnMk5EzBHS5qIwh96Sb2LYQfUFhTXoJnmeDLH+Fe7h13tQZYs6YTRO10VbH5TNwu6x0EgSzmodYWWhdwCjhcJw/98EKfHUf3Z1Ia8ZlPW/F1GZfbd6laGpanE9",
"policy": "eyJleHBpcmF0aW9uIjogIjIwMjEtMDItMDJUMTE6MzM6MDNaIiwgImNvbmRpdGlvbnMiOiBbeyJidWNrZXQiOiAiaW5kMS1taXRoaS12djQtZGMxLWFwaS10ZW1wLW1haWxzdG9yYWdlLXMzIn0sIHsia2V5IjogInczOHE1cXdoZ2ovMjAyMS8wMi8wMi8xMS8yOTcxZGRiMy0xMDU4LTRhZjktYmE5ZC1jOTI1ZTUxYWZjYTcuZW1sIn0sIHsieC1hbXotYWxnb3JpdGhtIjogIkFXUzQtSE1BQy1TSEEyNTYifSwgeyJ4LWFtei1jcmVkZW50aWFsIjogIkFTSUFVRkM0NE9JQ0I2T0lPTk5DLzIwMjEwMjAyL2FwLXNvdXRoLTEvczMvYXdzNF9yZXF1ZXN0In0sIHsieC1hbXotZGF0ZSI6ICIyMDIxMDIwMlQxMTI4MDNaIn0sIHsieC1hbXotc2VjdXJpdHktdG9rZW4iOiAiSVFvSmIzSnBaMmx1WDJWakVPdi8vLy8vLy8vLy93RWFDbUZ3TFhOdmRYUm9MVEVpU0RCR0FpRUFvNlZ0NFl2SkJPNFQ5MHRaTDlaOHlYU0lBU2diTlBWNUdyNGpXeENXeGdBQ0lRQ2NsRWtFRVJFSHJNREdiYnZwUVoyZFg0anlsNFN0VlFkcS82SW1tVUdKeHlyM0FRalUvLy8vLy8vLy8vOEJFQUFhRERJNE5UZ3hNREV5TnpNMk5DSU1Dd3c2T0kydjZGMHY4U3FYS3NzQmVwUG8vQWJ4ZEd0RjNINWkwU1BTMVd4bkpPMjE3VmZ6WmFTQzhld042MXZFdnMxcmg2cU92VmtBdGhsVTFnV3FPYlNZS0hScTJYc1Z5Ky9RaHJ2NndZL284TG4yNGdudWtzdHNCTGR4SFlJQWRKQWdOWWoyMVIzSFlSdm1oVHF5TXJLclhjam8xTXBNUE1GcngxbHZoVldxaHlvU1FuMXBqVDY4dG4rZXphTkxCTU5Ddm44Tnd2VGJqKytwVFVudW5uazU0dFEzcmRJRjlGd3pwK3hOa2E1Yk90eCtDQTVxREF0YXFtNjJ2WVRISDQxQ3Z0QmduWk9oU1Voa2RUZ0wyc3BIcHo1M0p2ay9Va0l3anR2a2dBWTYzd0d5emJUMU55d3FaZlFEbEZkWml2bHNCMUJCQmJRd0JGSkRBZWNZWHlIZlh5WGpQZTQzdkhmaEExNWExdy83MHhWVXMwQWorUFB2QTBwTG84UkJoU3VCM29FeDRhTXVEWGx1SXFLcHVtOWgvZ2JqbGRka3VqRE0vYXZEUHhOYWJDVFJGeWJncUI0aytvZ0hkQUdOOUVPczJaUjBrZjBiam5WQ0RweFVpY0luY1IzUkhUbG5NazVFekJIUzVxSXdoOTZTYjJMWVFmVUZoVFhvSm5tZURMSCtGZTdoMTN0UVpZczZZVFJPMTBWYkg1VE53dTZ4MEVnU3ptb2RZV1doZHdDamhjSncvOThFS2ZIVWYzWjFJYThabFBXL0YxR1pmYmQ2bGFHcGFuRTkifV19",
"x-amz-signature": "cf60309b5a07cf78ff6c15f54d34e1ca6a4631773d13a97699c5fb8e1659fde7"
"file": "<Processed mail as String>"
Success Response:
If the upload request succeeds, the response includes a 204 No Content HTTP status code.
Error Response:
If the request is made past 5 minutes.
HTTP Status : 400
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>AccessDenied</Code>
<Message>Invalid according to Policy: Policy expired.</Message>
<RequestId>B3321ECB582BF425</RequestId>
<HostId>WDU/zq1OqkcX9ry/AE4rG89u02Q0tq/C9roZq+o7ZdVrKqvDJCyC2v0Yn8PNf7YYrbqkVUg1sG0=</HostId>
</Error>