A Ruby on Rails plugin for Uploadcare service. Based on uploadcare-ruby gem (general purpose wrapper for Uploadcare API)
❗ Note: the gem uploadcare-rails 2.x is not backward compatible with 1.x.
- ruby 2.7+
- Ruby on Rails 6.0+
Add this line to your application's Gemfile:
gem "uploadcare-rails"
And then execute:
$ bundle install
If you use api_struct
gem in your project, replace it with uploadcare-api_struct
:
gem 'uploadcare-api_struct'
and run bundle install
$ gem install uploadcare-rails
To start using Uploadcare API you just need to set your API keys (public key and secret key).
These keys can be set as ENV variables using the export
directive:
$ export UPLOADCARE_PUBLIC_KEY=your_public_key
$ export UPLOADCARE_SECRET_KEY=your_private_key
Or you can use popular gems like dotenv-rails
for setting ENV variables.
You must set the gem before uploadcare-rails
like this :
gem "dotenv-rails", require: "dotenv/rails-now", groups: [:development, :test]
gem "uploadcare-rails"
require: "dotenv/rails-now"
is very important!
Run the config generator command to generate a configuration file:
$ rails g uploadcare_config
The generator will create a new file in config/initializers/uploadcare.rb
.
The public key must be specified in config/initializers/uploadcare.rb
to use Uploadcare file upload.
This step is done automatically in the initializer if you set the ENV variable UPLOADCARE_PUBLIC_KEY
earlier.
...
Uploadcare::Rails.configure do |config|
# Sets your Uploadcare public key.
config.public_key = ENV.fetch("UPLOADCARE_PUBLIC_KEY", "your_public_key")
...
end
There are also some options set by default:
...
# Deletes files from Uploadcare servers after object destroy.
config.delete_files_after_destroy = true
# Sets caching for Uploadcare files
config.cache_files = true
# Available locales currently are:
# ar az ca cs da de el en es et fr he it ja ko lv nb nl pl pt ro ru sk sr sv tr uk vi zhTW zh
config.locale = "en"
# If true, inputs on your page are initialized automatically, see the article for details -
# https://uploadcare.com/docs/file-uploader-api/widget-initialization/
config.live = true
# If true, input initialization is invoked manually.
# See https://uploadcare.com/docs/file-uploader-api/widget-initialization/).
config.manual_start = false
Then you can configure all global variables such as files storing/caching, deleting files, etc. Full list of available options is listed in the file itself. Just uncomment an option and set the value.
The fastest way to start using file uploading is to add the Uploadcare widget to the html-page. There is a view helper that can do it with two strings of code:
Add this string to your <head>
html-tag
<!DOCTYPE html>
<html>
<head>
<title>RailsApp</title>
<%= uploadcare_include_tag %>
<!--
results in:
<script src="https://ucarecdn.com/libs/widget/3.x/uploadcare.full.min.js"></script>
<script>
//<![CDATA[
UPLOADCARE_PUBLIC_KEY = "your_public_key";
UPLOADCARE_LOCALE = "en";
UPLOADCARE_LIVE = true;
UPLOADCARE_MANUAL_START = false;
//]]>
</script>
-->
</head>
...
This helper uses a CDN-url for the widget bundle and supports three options:
- version — version of the Uploadcare widget. Default is "3.x".
- bundle — bundle name. Available names are "full", "default", "api", "ie8" and "lang.en". Default bundle is "full" — a full bundle with built-in jQuery. More info about bundles here.
- min — bool value detecting if the bundle must be minified.
The <head>
tag then also includes the <script>
with widget global settings set in config/initializers/uploadcare.rb
. You can override them later in an individual widget.
Download and append widget manually to your asset pipeline. You may download (e.g. https://ucarecdn.com/libs/widget/3.x/uploadcare.full.min.js) and serve the widget yourself along with your other assets.
Installing via NPM instructions can be found here.
When the widget is on a html-page, you want to add an input to your view that will be used by the File Uploader:
...
<%= uploadcare_uploader_field :object, :attribute %>
<!--
results in:
<input role="uploadcare-uploader" type="hidden" name="object[attribute]" id="object_attribute">
-->
...
- object — object name;
- attribute — object attribute name.
View helpers are good to be used for Rails models.
First, you need to mount uploadcare file or group to the model attribute.
For example you have a database table like this and model Post
:
# DB table "posts"
---------------------
title | String
---------------------
picture | String
---------------------
attachments | String
---------------------
# app/models/post.rb
class Post < ApplicationRecord
mount_uploadcare_file :picture
end
<!-- app/views/posts/new.html.erb -->
<h1> NEW POST </h1>
<%= form_tag("/posts", method: :post) do %>
<%= uploadcare_uploader_field :post, :picture %>
<!--
results in:
<input role="uploadcare-uploader" multiple="false" type="hidden" name="post[picture]" id="post_picture">
-->
<div>
<%= submit_tag "Save" %>
</div>
<% end %>
# app/models/post.rb
class Post < ApplicationRecord
mount_uploadcare_file_group :attachments
end
<!-- app/views/posts/new.html.erb -->
<h1> NEW POST </h1>
<%= form_tag("/posts", method: :post) do %>
<%= uploadcare_uploader_field :post, :attachments %>
<!--
results in:
<input role="uploadcare-uploader" multiple="true" type="hidden" name="post[attachments]" id="post_attachments">
-->
<div>
<%= submit_tag "Save" %>
</div>
<% end %>
The input will have a value
property set to CDN-urls when you will select files to upload in the widget.
<input role="uploadcare-uploader" type="hidden" name="post[picture]" id="post_picture" value="https://ucarecdn.com/8355c2c5-f108-4d74-963d-703d48020f83/">
So, you get CDN-urls as a value of the attribute in the controller on form submit.
The value will be available in the controller by params[:post][:picture]
.
The helper is detecting the value of the multiple
property based on the mount type in your model.
If you are facing issue, with multiple input elements being rendered due to turbolinks caching you can append this fix in the app/javascript/application.js
to overcome this:
document.addEventListener('turbolinks:before-cache', function() {
const dialogClose = document.querySelector('.uploadcare--dialog__close');
if (dialogClose) {
dialogClose.dispatchEvent(new Event('click'));
}
const dialog = document.querySelector('.uploadcare--dialog');
if (dialog) {
dialog.remove();
}
const widgets = document.querySelectorAll('.uploadcare--widget');
widgets.forEach(widget => {
widget.remove();
});
});
Similarly if you are using Hotwire then use can you use below code:
document.addEventListener('turbo:before-cache', function() {
const dialogClose = document.querySelector('.uploadcare--dialog__close');
if (dialogClose) {
dialogClose.dispatchEvent(new Event('click'));
}
const dialog = document.querySelector('.uploadcare--dialog');
if (dialog) {
dialog.remove();
}
const widgets = document.querySelectorAll('.uploadcare--widget');
widgets.forEach(widget => {
widget.remove();
});
});
When you mount either Uploadcare File or Group to an attribute, this attribute is getting wrapped with a Uploadcare object. This feature adds some useful methods to the attribute.
Say, you have such model in your Rails app:
# app/models/post.rb
class Post < ApplicationRecord
mount_uploadcare_file :picture
end
And then you create a new Post object specifying a CDN-url for your previously uploaded Uploadcare file:
post = Post.create(picture: "https://ucarecdn.com/2d33999d-c74a-4ff9-99ea-abc23496b052/")
Now the post.picture
is an Uploadcare::Rails::File. Following methods are supported:
# Store the file on an Uploadcare server permanently:
post.picture.store
# => {
# "cdn_url"=>"https://ucarecdn.com/2d33999d-c74a-4ff9-99ea-abc23496b052/",
# ...other group data...
# }
#
# Delete the file from an Uploadcare server permanently:
post.picture.delete
# => {
# "datetime_removed"=>"2021-07-30T09:19:30.797174Z",
# ...other group data...
# }
# Get CDN-url of an object attribute:
post.picture.to_s
# => "https://ucarecdn.com/2d33999d-c74a-4ff9-99ea-abc23496b052/"
# Load object (send a GET request to the server to get all the file's data)
# This data will be cached if the cache_files option is set to true
# Default data (without asking an Uploadcare server) for each file contains cdn_url and uuid only:
post.picture.load
# => {
# "cdn_url"=>"https://ucarecdn.com/2d33999d-c74a-4ff9-99ea-abc23496b052/",
# ...other file data...
# }
# Check if an attribute loaded from the server.
# Will return false unless the :load or the :store methods are called:
post.picture.loaded?
# => true
# More about image transformations below.
# Transform a CDN-url to get a new transformed image's source. Works for images only:
post.picture.transform_url(quality: "better")
# => "https://ucarecdn.com/2d33999d-c74a-4ff9-99ea-abc23496b052/-/quality/better/"
Groups work similar to the File but have some differences though.
# app/models/post.rb
class Post < ApplicationRecord
mount_uploadcare_file_group :attachments
end
Creating a new post
with the Group mounted:
post = Post.create(attachments: "https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/")
Now the post.attachments
is an Uploadcare::Rails::Group. Following methods are supported:
# Store the file group on an Uploadcare server permanently:
post.attachments.store
# => {
# "cdn_url"=>"https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/",
# ...other group data...
# "files"=> [{
# "datetime_stored"=>"2021-07-29T08:31:45.668354Z",
# ...other file data...
# }]
# }
#
# Delete the file group from an Uploadcare server permanently:
post.attachments.delete
# => {
# "datetime_removed"=>"2021-07-30T09:19:30.797174Z",
# ...other group data...
# }
# Get CDN-url of an object attribute:
post.attachments.to_s
# => "https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/"
# Load object — works the same way as for the File:
post.attachments.load
# => {
# "cdn_url"=>"https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/",
# ...other group data...
# "files"=> [{
# "datetime_stored"=>"2021-07-29T08:31:45.668354Z",
# ...other file data...
# }]
# }
# Check if an attribute loaded from the server:
post.attachments.loaded?
# => true
# As we don't want to show (on the html-page) a file group itself,
# we can get CDN-urls for file that the group contains. No loading group or files needed.
# This works for images only:
post.attachments.transform_file_urls(quality: "better")
# => ["https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/nth/0/-/quality/better/"]
# If you want to get non-transformed file urls, use:
post.attachments.file_urls
# => ["https://ucarecdn.com/dbc4e868-b7a6-43ff-a35f-2ebef935dc1b~1/nth/0/"]
Uploadcare provides a way to transform images stored on Uploadcare services specifying a list of operations. If an operation has just one option, you can specify it like key-value:
post.picture.transform_url(quality: "better")
# => "https://ucarecdn.com/ebbb9929-eb92-4f52-a212-eecfdb19d27d/-/quality/better/"
and if an operation supports several options — just set them as a Hash:
post.picture.transform_url(crop: { dimensions: "300x500", coords: "50, 50", alignment: "center" })
# => "https://ucarecdn.com/ebbb9929-eb92-4f52-a212-eecfdb19d27d/-/crop/300x500/50,50/center/"
Full list of operations and valid values can be found here.
Uploadcare provides APIs to manage files, group, projects, webhooks, video and documents conversion and file uploads. The gem has unified interfaces to use Uploadcare APIs in RailsApp.
Upload Api provides methods to upload files in many ways.
# Load a file
file = File.open("kitten.png")
# => #<File:kitten.png>
# Upload file to Uploadcare
uploadcare_file = Uploadcare::UploadApi.upload_file(file)
# => {
# "uuid"=>"2d33999d-c74a-4ff9-99ea-abc23496b053",
# ...other file data...
# }
This method supports single file uploading and uploading files from an URL (depending on the type of first argument - can be either String (i.e. URL) or File).
# Upload file from URL
url = "https://ucarecdn.com/80b807be-faad-4f01-bbbe-0bbde172b9de/1secVIDEO.mp4"
uploadcare_file = Uploadcare::UploadApi.upload_file(url)
# => [
# {
# "size"=>22108,
# "uuid"=>"b5ed5e1d-a939-4fe4-bfb2-31d3867bb6s6",
# "original_filename"=>"1 sec VIDEO.mp4",
# "is_image"=>false,
# "image_info"=>nil,
# "is_ready"=>true,
# "mime_type"=>"video/mp4"
# }
# ]
# Load a file
file = File.open("kitten.png")
# => #<File:kitten.png>
# Upload several files to Uploadcare
uploadcare_file = Uploadcare::UploadApi.upload_files([file])
# => [
# {
# "uuid"=>"2dfc94e6-e74e-4014-9ff5-a71b8928f4fa",
# "original_filename"=>:"kitten.png"
# }
# ]
FileApi provides an interface to manage single files, stored on Uploadcare Servers.
# Valid options:
# removed: [true|false]
# stored: [true|false]
# limit: (1..1000)
# ordering: ["datetime_uploaded"|"-datetime_uploaded"]
# from: A starting point for filtering files. The value depends on your ordering parameter value.
Uploadcare::FileApi.get_files(ordering: "datetime_uploaded", limit: 10)
# => {
# "next"=>nil,
# "previous"=>nil,
# "total"=>2,
# "per_page"=>10,
# "results"=> [
# {
# "datetime_removed"=>nil,
# ... file data ...
# }
# ]
# }
$ Uploadcare::FileApi.get_file("7b2b35b4-125b-4c1e-9305-12e8da8916eb")
# => {
# "cdn_url"=>"https://ucarecdn.com/7b2b35b4-125b-4c1e-9305-12e8da8916eb/",
# ...other file data...
# }
# Valid options:
# stored: [true|false]
Uploadcare::FileApi.local_copy_file("2d33999d-c74a-4ff9-99ea-abc23496b052", store: false)
# => {
# "uuid"=>"f486132c-2fa5-454e-9e70-93c5e01a7e04",
# ...other file data...
# }
# Valid options:
# make_public: [true|false]
Uploadcare::FileApi.remote_copy_file("2d33999d-c74a-4ff9-99ea-abc23496b052", "mytarget", make_public: false)
# => {
# "uuid"=>"f486132c-2fa5-454e-9e70-93c5e01a7e04",
# ...other file data...
# }
Uploadcare::FileApi.store_file("2d33999d-c74a-4ff9-99ea-abc23496b052")
# => {
# "uuid"=>"2d33999d-c74a-4ff9-99ea-abc23496b052",
# ...other file data...
# }
Uploadcare::FileApi.store_files(["f486132c-2fa5-454e-9e70-93c5e01a7e04"])
# => {
# "result" => [
# {
# "uuid"=>"f486132c-2fa5-454e-9e70-93c5e01a7e04",
# ...other file data...
# }
# ]
# }
Uploadcare::FileApi.delete_file("2d33999d-c74a-4ff9-99ea-abc23496b052")
# => {
# "uuid"=>"2d33999d-c74a-4ff9-99ea-abc23496b052",
# ...other file data...
# }
Uploadcare::FileApi.delete_files(["f486132c-2fa5-454e-9e70-93c5e01a7e04"])
# => {
# "result" => [
# {
# "uuid"=>"f486132c-2fa5-454e-9e70-93c5e01a7e04",
# ...other file data...
# }
# ]
# }
GroupApi provides an interface to manage file groups stored on Uploadcare Servers.
# Valid options:
# limit: (1..1000)
# ordering: ["datetime_created"|"-datetime_created"]
# from: A starting point for filtering group lists. MUST be a datetime value with T used as a separator.
# example: "2015-01-02T10:00:00"
Uploadcare::GroupApi.get_groups(ordering: "datetime_uploaded", limit: 10)
# => {
# "next"=>"next"=>"https://api.uploadcare.com/groups/?ordering=datetime_uploaded&limit=10&from=2021-07-16T11%3A12%3A12.236280%2B00%3A00&offset=0",
# "previous"=>nil,
# "total"=>82,
# "per_page"=>10,
# "results"=> [
# {
# "id"=>"d476f4c9-44a9-4670-88a5-c3cf5a26b6c2~20",
# "datetime_created"=>"2021-07-16T11:03:01.182239Z",
# "datetime_stored"=>nil,
# "files_count"=>20,
# "cdn_url"=>"https://ucarecdn.com/d476f4c9-44a9-4670-88a5-c3cf5d16b6c2~20/",
# "url"=>"https://api.uploadcare.com/groups/d476f4c9-44a9-4670-83a5-c3cf5d26b6c2~20/"
# },
# ... other groups data ...
# ]
# }
Uploadcare::GroupApi.get_group("d476f4c9-44a9-4670-88a5-c3cf5d26a6c2~20")
# => {
# "cdn_url"=>"https://ucarecdn.com/d476f4c9-44a9-4670-88a5-c3cf5d26a6c2~20/",
# ...other group data...
# "files"=> [{
# "datetime_stored"=>"2021-07-29T08:31:45.668354Z",
# ...other file data...
# }]
# }
Uploadcare::GroupApi.store_group("d476f4c9-44a9-4670-88a5-c3cf5d26a6c2~20")
# => "200 OK"
It is possible to specify transformed URLs with UUIDs of files OR just UUIDs.
NOTE: Be sure to add a trailing slash "/" to the URL in case of specifying transformed URLs.
Uploadcare::GroupApi.create_group(["e08dec9e-7e25-49c5-810e-4c360d86bbae/-/resize/300x500/"])
# => {
# "cdn_url"=>"https://ucarecdn.com/d476f4c9-44a9-4670-88a5-c3cf5d26a6c2~1/",
# ...other group data...
# "files"=> [{
# "datetime_stored"=>"2021-07-29T08:31:45.668354Z",
# ...other file data...
# }]
# }
Uploadcare::GroupApi.delete_group("90c93e96-965b-4dd2-b323-39d9bd5f492c~1")
# => "200 OK"
ProjectApi interface provides just one method - to get a configuration of your Uploadcare project.
Uploadcare::ProjectApi.get_project
# => {
# "collaborators"=>[],
# "name"=>"New project",
# "pub_key"=>"your_public_key",
# "autostore_enabled"=>true
# }
WebhookApi allows to manage Uploadcare webhooks.
This method returns a non-paginated list of webhooks set in your project
Uploadcare::WebhookApi.get_webhooks
# => [{
# "id"=>815677,
# "created"=>"2021-08-02T05:02:14.588794Z",
# "updated"=>"2021-08-02T05:02:14.588814Z",
# "event"=>"file.uploaded",
# "target_url"=>"https://example.com",
# "project"=>123682,
# "is_active"=>true
# }]
This method requires an URL that is triggered by an event, for example, a file upload. A target URL MUST be unique for each project — event type combination.
Each webhook payload can be signed with a secret (the signing_secret
option) to ensure that the request comes from the expected sender.
More info about secure webhooks here.
# Valid options:
# event: ["file.uploaded"]
# is_active: [true|false]
Uploadcare::WebhookApi.create_webhook("https://example.com", event: "file.uploaded", is_active: true, signing_secret: "some-secret")
# => {
# "id"=>815671,
# "created"=>"2021-08-02T05:02:14.588794Z",
# "updated"=>"2021-08-02T05:02:14.588814Z",
# "event"=>"file.uploaded",
# "target_url"=>"https://example.com",
# "project"=>123682,
# "is_active"=>true
# }
Updating a webhook is available if webhook ID is known. The ID is returned in a response on creating or listing webhooks. Setting a signing secret is supported when updating a webhook as well.
# Valid options:
# event: Presently, we only support the "file.uploaded" event
# is_active: [true|false]
Uploadcare::WebhookApi.update_webhook("webhook_id", target_url: "https://example1.com", event: "file.uploaded", is_active: false, signing_secret: "some-secret")
# => {
# "id"=>815671,
# "created"=>"2021-08-02T05:02:14.588794Z",
# "updated"=>"2021-08-02T05:02:14.588814Z",
# "event"=>"file.uploaded",
# "target_url"=>"https://example1.com",
# "project"=>123682,
# "is_active"=>false
# }
Uploadcare::WebhookApi.delete_webhook("https://example1.com")
# => Success(nil)
ConversionApi provides methods to manage video and documents conversion.
This method requires an UUID of a previously uploaded to Uploadcare file and target format. If using an image format, you can also specify a page number that must be converted for a document containing pages. More info about document conversion can be found here.
Uploadcare::ConversionApi.convert_document(
{ uuid: "466740dd-cfad-4de4-9218-1ddc0edf7aa6", format: "png", page: 1 },
store: false
)
# => Success({
# :result=>[{
# :original_source=>"466740dd-cfad-4de4-9218-1ddc0edf7aa6/document/-/format/png/-/page/1/",
# :token=>21316034,
# :uuid=>"db6e52b8-cc03-4174-a07a-012be43b144e"
# }],
# :problems=>{}
# })
This method requires a token obtained in a response to the convert_document method.
Uploadcare::ConversionApi.get_document_conversion_status(21316034)
# => Success({
# :result=>{
# :uuid=>"db6e52b8-cc03-4174-a07a-012be43b144e"
# },
# :error=>nil,
# :status=>"finished"
# })
Such as the document conversion method, this method requires an UUID of a previously uploaded to Uploadcare file. Also you have several options to control the way a video will be converted. All of them are optional. Description of valid options and other info about video conversion can be found here.
Uploadcare::ConversionApi.convert_video(
{
uuid: "466740dd-cfad-4de4-9218-1ddc0edf7aa6",
format: "ogg",
quality: "best",
cut: { start_time: "0:0:0.0", length: "0:0:1.0" },
thumbs: { N: 2, number: 1 }
},
store: false
)
# => Success({
# :result=>[{
# :original_source=>"80b807be-faad-4f01-bbbe-0bbde172b9de/video/-/size/600x400/change_ratio/-/quality/best/-/format/ogg/-/cut/0:0:0.0/0:0:1.0/-/thumbs~2/1/",
# :token=>916090555,
# :uuid=>"df597ef4-59e7-47ef-af5d-365d8409934c~2",
# :thumbnails_group_uuid=>"df597ef4-59e7-47ef-af5d-365d8409934c~2"
# }],
# :problems=>{}
# })
This method requires a token obtained in a response to the convert_video method.
Uploadcare::ConversionApi.get_video_conversion_status(916090555)
# => Success({
# :result=>{
# :uuid=>"f0a3e66e-cd22-4397-ba0a-8a8becc925f9",
# :thumbnails_group_uuid=>"df597ef4-59e7-47ef-af5d-365d8409934c~2"
# },
# :error=>nil,
# :status=>"finished"
# })
File metadata is additional, arbitrary data, associated with uploaded file. As an example, you could store unique file identifier from your system. Metadata is key-value data.
Uploadcare::FileMetadataApi.file_metadata('f757ea10-8b1a-4361-9a7c-56bfa5d45176')
# => {:"sample-key"=>"sample-value"}
Uploadcare::FileMetadataApi.file_metadata_value('f757ea10-8b1a-4361-9a7c-56bfa5d45176', 'sample-key')
# => "sample-value"
If the key does not exist, it will be created.
Uploadcare::FileMetadataApi.update_file_metadata('f757ea10-8b1a-4361-9a7c-56bfa5d45176', 'sample-key', 'new-value')
# => "new-value"
Uploadcare::FileMetadataApi.delete_file_metadata('f757ea10-8b1a-4361-9a7c-56bfa5d45176', 'sample-key')
# => "200 OK"
An Add-On is an application implemented by Uploadcare that accepts uploaded files as an input and can produce other files and/or appdata as an output.
Note: Detected labels are stored in the file's appdata.
Uploadcare::AddonsApi.rekognition_detect_labels('f757ea10-8b1a-4361-9a7c-56bfa5d45176')
# => {"request_id"=>"dfeaf81c-5c0d-49d5-8ed4-ac09bac7998e"}
Check the status of an Add-On execution request that had been started using the Execute Add-On operation
Uploadcare::AddonsApi.rekognition_detect_labels_status('dfeaf81c-5c0d-49d5-8ed4-ac09bac7998e')
# => {"status"=>"done"}
Execute AWS Rekognition Moderation Add-On for a given target to detect moderation labels in an image.
Note: Detected labels are stored in the file's appdata.
Uploadcare::AddonsApi.rekognition_detect_moderation_labels('f757ea10-8b1a-4361-9a7c-56bfa5d45176')
# => {"request_id"=>"dfeaf81c-5c0d-49d5-8ed4-ac09bac7998e"}
Check the status of an AWS Rekognition Moderation Add-On execution request that had been started using the Execute Add-On operation.
Uploadcare::AddonsApi.rekognition_detect_moderation_labels_status('dfeaf81c-5c0d-49d5-8ed4-ac09bac7998e')
# => {"status"=>"done"}
Uploadcare::AddonsApi.virus_scan('dfeaf81c-5c0d-49d5-8ed4-ac09bac7998e')
# => {"request_id"=>"1b0126de-ace6-455b-82e2-25f4aa33fc6f"}
Check the status of an Add-On execution request that had been started using the Execute Add-On operation
Uploadcare::AddonsApi.virus_scan_status('1b0126de-ace6-455b-82e2-25f4aa33fc6f')
# => {"status"=>"done"}
Uploadcare::AddonsApi.remove_bg('f757ea10-8b1a-4361-9a7c-56bfa5d45176')
# => {"request_id"=>"6d26a7d5-0955-4aeb-a9b1-c9776c83aa4c"}
Check the status of an Add-On execution request that had been started using the Execute Add-On operation
Uploadcare::AddonsApi.remove_bg_status('6d26a7d5-0955-4aeb-a9b1-c9776c83aa4c')
# => {"status"=>"done", "result"=>{"file_id"=>"8f0a2a28-3ed7-481e-b415-ee3cce982aaa"}}