Image Storage configuration

Please, be informed that in our editor, you can upload images in PNG, JPG, or GIF formats with a maximum size of 3 MB. The maximum image resolution is 4000x4000 pixels.

You have several options to configure storage for your pics. Choose and configure the most convenient way in My organization menu.

Stripo storage

Stripo storage is connected by default. It has no capacity or time limits.

Custom AWS S3 bucket

Custom AWS S3 feature allows you to easily connect your own Amazon Web Services S3 bucket to store images.

When choosing this option, you have to fill out the form to set a connection with your storage. Here is a description of the form fields with specifications regarding what information you need to add to each of them.

Please be sure that the provided account has reading and editing access to your bucket. Take a look at Helpers section for more details on how to configure your AWS S3 storage More about AWS credentials.

Azure Blob storage

Azure Blob storage is a feature that allows you to easily connect your own Azure storage account to store images.

To do this, first of all you need to create a storage account after that open the settings tab and generate the connection string in your Azure portal account:

Please be advised that you need to copy all the data from the connection string field, including the BlobEndpoint=

Other storages

We created a way to connect to a custom file system provider (via HTTP protocol) that allows you to use Stripo editor with your own file storage, no matter which technology you use.

A custom file system provider is an API that allows Stripo editor to connect your file system to Stripo’s file manager.

If you want to choose Other storage your server should support 4 types of requests as follows below.

GET LIST OF FILES

GET: /?guid=GUID_VALUE 
Host: YOUR_BASE_URL 
Content-Type: application/json 
Accept: application/json 

Response: [
    {
        "url":DOC_URL",
        "originalName":"DOC_NAME",
        "uploadTime":"DOC_UPLOAD_TIME",
        "size":DOC_SIZE_IN_BYTES,
        "height":DOC_HEIGHT,
        "width":DOC_WIDTH,
        "thumbnailUrl":"DOC_PREVIEW_URL"
    }
]

Where:
 - guid - tab identifier with images in the email template.
 - url (string) - Mandatory. Absolute URL to the document. 
 - originalName (string) - Mandatory. Document name. 
 - uploadTime (long) - Mandatory. Document upload time in milliseconds (unixepoch). 
 - size (long) - Mandatory. Document size in bytes. 
 - width (integer) - Optional. Document width in pixels (px). 
 - height (integer) - Optional. Document height in pixels (px).  
 - thumbnailUrl (string) - Optional. The absolute url of document preview thumbnail.

UPLOAD FILE TO STORAGE

POST: /
Host: YOUR_BASE_URL
Content-Type: multipart/form-data
Accept: application/json
Body:  
"guid":"GUID_VALUE",  
"file": MULTIPART_FILE

Response: {
    "url":"DOC_URL",
    "originalName":"DOC_NAME",
    "uploadTime":"DOC_UPLOAD_TIME",
    "size":DOC_SIZE_IN_BYTES, 
    "height":DOC_HEIGHT,
    "width":DOC_WIDTH,
    "thumbnailUrl:DOC_PREVIEW_URL
}

Where:
with multipart/form-data request body containing fields:
 - guid - tab identifier with images in the email template.
 - file - the content of the file.
 - url (string) - Mandatory. Absolute URL to the document.  
- originalName (string) - Mandatory. Document name. 
 - uploadTime (long) - Mandatory. Document upload time in milliseconds (unixepoch). 
 - size (long) - Mandatory. Document size in bytes. 
 - width (integer) - Optional. Document width in pixels (px). 
 - height (integer) - Optional. Document height in pixels (px).  
 - thumbnailUrl (string) - Optional. The absolute url of document preview thumbnail.

GET FILE INFO

GET: /info?src=DOC_URL
Host: YOUR_BASE_URL
Content-Type: application/json
Accept: application/json

Response:{
    "originalName":"DOC_ORIGINAL_NAME",
    "size":DOC_SIZE_IN_BYTES
}

Where:
 - src - image URL.
 - originalName (string) - Mandatory. Document name. 
 - size (long) - Mandatory. Document size in bytes.

CLONE DOCUMENTS when copying email templates with images

POST: /clone
Host: YOUR_BASE_URL
Content-Type: application/json
Accept: application/json

Body: 
{ 
"guidFrom":"GUID_VALUE_FROM",  
"guidTo":"GUID_VALUE_TO", 
"urls": ["DOC_URL1, DOC_URL2] // array of doc urls that should be copied 
}

Response:  
[ 
     { 
"sourceKey":"DOC_URL", 
"targetKey":"DOC_URL" 
     } 
]

Where:
 - guidFrom - identifier of the tab in the email template, whose images will be cloned.
 - guidTo - identifier of the tab in the email template where the images will be cloned.
 - urls - array of addresses of images to be cloned.
 - sourceKey (string) - URL of the original document that should be copied. 
 - targetKey (string) - URL of the resulted document that was copied

The Basic Authentication is used to send these requests, so please be sure that you specified correct Login, Password and API URL in the Stripo Integration menu of your Stripo account.