{"id":21923,"date":"2019-07-15T15:37:45","date_gmt":"2019-07-15T15:37:45","guid":{"rendered":"http:\/\/ftp_api_for_cloudinary_part_1_real_time_synchronization"},"modified":"2019-07-15T15:37:45","modified_gmt":"2019-07-15T15:37:45","slug":"ftp_api_for_cloudinary_part_1_real_time_synchronization","status":"publish","type":"post","link":"https:\/\/cloudinary.com\/blog\/ftp_api_for_cloudinary_part_1_real_time_synchronization","title":{"rendered":"FTP API for Cloudinary: Real-Time Synchronization"},"content":{"rendered":"

tl;dr Diagrams and blueprints for FTPing on Cloudinary<\/h4>\n
\n

As a robust, effective solution for managing digital media, Cloudinary offers a RESTful API for provisioning and maintenance. That API enables numerous operations, from basic ones like image uploads to advanced ones, such as creation of named transformations and AI-based search.<\/p>\n

However, despite its versatility for programming languages and frameworks, RESTful API does not<\/strong> comply with File Transfer Protocol (FTP), which has been in use for 50 years. Not only are FTP clients user-friendly, they can also seamlessly upload, delete, or download files in bulk and synchronize with the file system in question, whether automated or otherwise.<\/p>\n

We\u2019ve created the \u2018FTP API for Cloudinary\u2019, which translates FTP API calls into Cloudinary RESTful API calls. The FTP API enables you to use standard FTP clients for managing media assets in your Cloudinary account. Using this FTP API, you can maintain work procedures that involve FTP transfers.<\/p>\n

For example, suppose you migrate to Cloudinary and your organization is engaged with photography agencies. The agencies are used to sending their photoshoot files to you over FTP. You could take advantage of the FTP API for Cloudinary<\/strong> to avoid changing a smoothly working process, enabling a seamless transparent migration to Cloudinary.<\/p>\n

This post demonstrates how to use FTP on Cloudinary through an example of real-time synchronization. A second example on bulk uploads will be the subject of part 2 of this series.<\/p>\n

Note:<\/strong>

The FTP API for Cloudinary<\/strong> is based on the Amazon Web Services\u2019(AWS) Simple Storage Service (S3) and Python lambda. For the code in its entirety, see the blueprint in the Github repository<\/a>.<\/p><\/div>\n

The Process<\/h2>\n

The diagram below illustrates the process of a unidirectional synchronization of files to Cloudinary in real time with the FTP API.<\/p>\n

\"Diagram\"<\/p>\n

Here\u2019s the step-by-step workflow:<\/h3>\n
    \n
  1. The FTP source uploads a file to the user\u2019s S3 bucket.\nBe sure to set your bucket to accept Cloudinary\u2019s bucket GetObject<\/code> requests and to send event notifications. For details, see the blueprint.<\/li>\n
  2. S3 notifications are sent to an AWS Lambda.<\/li>\n
  3. The AWS lambda function sends an API Upload request to Cloudinary.<\/li>\n
  4. Cloudinary uploads the file from the user\u2019s S3 bucket.<\/li>\n<\/ol>\n

    This process has the following advantages over Cloudinary automated uploads<\/a> because\u2014<\/p>\n