Image and PDF compression API
We are happy to introduce the first API for images and PDF online compression with unique features such as unlimited and free sub-accounts, 1 month of media backup and restoration. We would be happy to provide you some help for your integration and product promotion, check the help and promotion for that.
Accounts
Accounts - Current account informations
/accounts/mine
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/mine'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
file_max_size | Int |
Max file size allowed to uplooad (in bytes) |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Current account informations
/accounts/mine
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/mine'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
file_max_size | Int |
Max file size allowed to uplooad (in bytes) |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Current account informations
/accounts/mine
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/mine'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
file_max_size | Int |
Max file size allowed to uplooad (in bytes) |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Current account consumption
/accounts/mine/consumption
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/mine/consumption'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
consumption | Object |
object |
last_days | Object[] |
Last 30 days of consumption |
date | Object |
Consumption date object |
total_size_before | Object |
Sum of bytes before optimization of all files sent this day |
total_size_after | Object |
Sum of bytes after optimization of all files sent this day |
files_count | Object |
Number of files optimized this day |
last_months | Object[] |
Last months of consumption |
date | Object |
Consumption date object |
total_size_before | Object |
Sum of bytes before optimization of all files sent this month |
total_size_after | Object |
Sum of bytes after optimization of all files sent this month |
files_count | Object |
Number of files optimized this day |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Current account consumption
/accounts/mine/consumption
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/mine/consumption'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
consumptions | Object[] |
Consumption (Array of Objects) |
date | Object |
Consumption date object |
date | Int |
Consumption day |
consumption | Int |
Total consumption of the day |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Subaccounts list
/accounts/sub/
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
items | Objects[] |
List of subaccounts (Array of Objects) |
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
Subaccount first day of current month quota calculation |
quota_end | Date |
Subaccount last day of current month quota calculation |
quota_allowed | String |
Subaccount allowed monthly quota (in bytes) |
quota_current | String |
Subaccount current consumption (in bytes) |
file_max_size | String |
Subaccount allowed max files size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Subaccounts list
/accounts/sub/
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
items | Objects[] |
List of subaccounts (Array of Objects) |
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
Subaccount first day of current month quota calculation |
quota_end | Date |
Subaccount last day of current month quota calculation |
quota_allowed | String |
Subaccount allowed monthly quota (in bytes) |
quota_current | String |
Subaccount current consumption (in bytes) |
file_max_size | String |
Subaccount allowed max files size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Subaccount informations
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Subaccount informations
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Create subaccount
/accounts/sub
Permission: need authentication through additional parameters
curl -X POST
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
-d 'title="New subaccount"'
-d 'description="This is my description"'
-d 'quota="524288000"'
'https://api.imagerecycle.com/v1/accounts/sub'
Post parameters
Field | Type | Description |
---|---|---|
title | String |
Subaccount title |
description | String |
Subaccount description |
quota | Int |
Subaccount allowed monthly quota (in bytes) |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 201
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Create subaccount
/accounts/sub
Permission: need authentication through additional parameters
curl -X POST
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
-d 'title="New subaccount"'
-d 'description="This is my description"'
-d 'monthly_quota="524288000"'
'https://api.imagerecycle.com/v1/accounts/sub'
Post parameters
Field | Type | Description |
---|---|---|
title | String |
Subaccount title |
description | String |
Subaccount description |
monthly_quota | Int |
Subaccount allowed monthly quota (in bytes) |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 201
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Delete subaccount
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
Success | Boolean |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Delete subaccount
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
Success | Boolean |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Edit subaccount fields
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X PUT
-d 'title="My new title"'
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Post parameters
Field | Type | Description |
---|---|---|
title | String |
Subaccount title |
description | String |
Subaccount description |
quota | Int |
Subaccount allowed monthly quota (in bytes) |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Edit subaccount fields
/accounts/sub/:id
Permission: need authentication through additional parameters
curl -X PUT
-d 'title="My new title"'
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/accounts/sub/123'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Post parameters
Field | Type | Description |
---|---|---|
title | String |
Subaccount title |
description | String |
Subaccount description |
monthly_quota | Int |
Subaccount allowed monthly quota (in bytes) |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Reset subaccount API secret
/accounts/sub/reset_secret/:id
Permission: need authentication through additional parameters
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret curl -X PUT -d 'auth={"key":"your_api_key","secret":"your_api_secret"}' 'https://api.imagerecycle.com/v1/accounts/sub/reset_secret/123' |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Reset subaccount API secret
/accounts/sub/reset_secret/:id
Permission: need authentication through additional parameters
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret curl -X PUT -d 'auth={"key":"your_api_key","secret":"your_api_secret"}' 'https://api.imagerecycle.com/v1/accounts/sub/reset_secret/123' |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Accounts - Reset subaccount consummate quota
/accounts/sub/reset_quota/:id
Permission: need authentication through additional parameters
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
account id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Subaccount id |
title | String |
Subaccount title |
description | String |
Subaccount description |
quota_start | Date |
First day of current month quota calculation |
quota_end | Date |
Last day of current month quota calculation |
quota_current | Int |
Current monthly consumption (in bytes) |
quota_allowed | Int |
Monthly allowed consumption (in bytes) |
quota_file_max_size | Int |
Max file size allowed to upload (in bytes) |
api_key | String |
Subaccount api key |
api_secret | String |
Subaccount api secret curl -X PUT -d 'auth={"key":"your_api_key","secret":"your_api_secret"}' 'https://api.imagerecycle.com/v1/accounts/sub/reset_quota/123' |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images
Images - Get images list
/images
Permission: logged account
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
items | Objects[] |
List of images (Array of Objects) |
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
total | Int |
Total number of items |
prev | Object |
Previous pagination object |
link | String |
Previous pagination link API address |
offset | Int |
Previous pagination offset |
limit | Int |
Previous pagination limit |
next | Object |
Next pagination object |
link | String |
Next pagination link API address |
offset | Int |
Next pagination offset |
limit | Int |
Next pagination limit |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Get images list
/images
Permission: logged account
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
items | Objects[] |
List of images (Array of Objects) |
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
total | Int |
Total number of items |
prev | Object |
Previous pagination object |
link | String |
Previous pagination link API address |
offset | Int |
Previous pagination offset |
limit | Int |
Previous pagination limit |
next | Object |
Next pagination object |
link | String |
Next pagination link API address |
offset | Int |
Next pagination offset |
limit | Int |
Next pagination limit |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Get an image
/images/:id
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images/3012'
Parameter
Field | Type | Description |
---|---|---|
id | Int |
Image id |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Get an image
/images/:id
Permission: need authentication through additional parameters
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images/3012'
Parameter
Field | Type | Description |
---|---|---|
id | Int |
Image id |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 200
Field | Type | Description |
---|---|---|
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Add a new image
/images
Permission: need authentication through additional parameters
curl -X POST
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
-d 'url=https://www.google.fr/images/srpr/logo11w.png'
-d 'params={"compression_type":"lossy"}'
'https://api.imagerecycle.com/v1/images'
Post parameters
Field | Type | Description |
---|---|---|
file optional | File |
File to send |
url optional | String |
an URL where download the file |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 201
Field | Type | Description |
---|---|---|
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 403 Forbidden
Field | Type | Description |
---|---|---|
errCode | Int |
403 Forbidden |
errMessage | String |
Error message |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Add a new image
/images
Permission: need authentication through additional parameters
curl -X POST
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
-d 'url=https://www.google.fr/images/srpr/logo11w.png'
-d 'params={"compression_type":"lossy"}'
'https://api.imagerecycle.com/v1/images'
Post parameters
Field | Type | Description |
---|---|---|
file optional | File |
File to send |
url optional | String |
an URL where download the file |
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 201
Field | Type | Description |
---|---|---|
id | Int |
Image id |
filename | String |
Image filename |
width | Int |
Image width |
height | Int |
Image height |
size_before | Int |
Image size before compression |
size_after | Int |
Image size after compression |
saved | Float |
Image saved proportion |
time | Date |
Image creation date |
origin_url | String |
{String} Image original download link |
optimized_url | String |
{String} Image optimized download link |
expiration_date | Date |
{String} Image expiration date |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 403 Forbidden
Field | Type | Description |
---|---|---|
errCode | Int |
403 Forbidden |
errMessage | String |
Error message |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Delete an image
/images/:id
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'http://imageoptimizerapi.local/v1/images/23189'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
Image id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 204
Field | Type | Description |
---|---|---|
Success | Object |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Delete an image
/images/:id
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'http://imageoptimizerapi.local/v1/images/23189'
Url parameters
Field | Type | Description |
---|---|---|
id | Int |
Image id |
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 204
Field | Type | Description |
---|---|---|
Success | Object |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Delete all images
/images/all
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 204
Field | Type | Description |
---|---|---|
Success | Object |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Delete all images
/images/all
Permission: need authentication through additional parameters
curl -X DELETE
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images'
Url parameters
Field | Type | Description |
---|---|---|
auth | json |
Authentication Object |
key | String |
Authentication key |
secret | String |
Authentication secret |
Success 204
Field | Type | Description |
---|---|---|
Success | Object |
Error 400 Bad Request
Field | Type | Description |
---|---|---|
errCode | Int |
The 400 http error code |
errMessage | String |
Query error |
Error 401 Unauthorized
Field | Type | Description |
---|---|---|
errCode | Int |
The http error code |
errMessage | String |
The last error message |
Images - Download a file
/images/:type/:token/:name
Permission: no permission required
curl -X GET
'https://api.imagerecycle.com/v1/images/optimized/cd493caac5e70f154c80141fccb5ad0a/logo11w.png'
Parameter
Field | Type | Description |
---|---|---|
type | String |
Image type Allowed values: |
token | String |
Image token Size range: |
name | String |
Image name |
Success 200
Field | Description |
---|---|
Return |
a file |
Error 404 Not found
Field | Description |
---|---|
ErrCode |
404 |
ErrMessage |
Not found |
Images - Download a file
/images/:type/:token/:name
Permission: no permission required
curl -X GET
'https://api.imagerecycle.com/v1/images/optimized/cd493caac5e70f154c80141fccb5ad0a/logo11w.png'
Parameter
Field | Type | Description |
---|---|---|
type | String |
Image type Allowed values: |
token | String |
Image token Size range: |
name | String |
Image name |
Success 200
Field | Description |
---|---|
Return |
a file |
Error 404 Not found
Field | Description |
---|---|
ErrCode |
404 |
ErrMessage |
Not found |
Images - Download a zip file
/images/zip/:type/:ids
Permission: no permission required
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images/zip/optimized/1230,1231,1400'
Url parameters
Field | Type | Description |
---|---|---|
type | String |
Image type Allowed values: |
ids | String |
list of comma separated ids to download |
Success 200
Field | Description |
---|---|
Return |
a zip file |
Error 404 Not found
Field | Description |
---|---|
ErrCode |
404 |
ErrMessage |
Not found |
Images - Download a zip file
/images/zip/:type/:ids
Permission: no permission required
curl -X GET
-d 'auth={"key":"your_api_key","secret":"your_api_secret"}'
'https://api.imagerecycle.com/v1/images/zip/optimized/1230,1231,1400'
Url parameters
Field | Type | Description |
---|---|---|
type | String |
Image type Allowed values: |
ids | String |
list of comma separated ids to download |
Success 200
Field | Description |
---|---|
Return |
a zip file |
Error 404 Not found
Field | Description |
---|---|
ErrCode |
404 |
ErrMessage |
Not found |
We are here to help
We have a private support ticket system with a dedicated developer. If you need information about API we would happy to help; register a free account and drop us a ticket in the API section. We can provide an account with quota of course for a testing purpose. API integration in new CMS or new extension for CMS are welcome as well as custom projects integrations. Note that we already have 4 CMS plugins and you may take a look at their code, download is free from our CMS pages.
We promote your work
We are proud that you choose and take time to integrate our extension/service with yours, so we can help with promotion too! by promotion we mean on our official blog, social networks and 3rd party reviews. Note that we also have an affilliate system and some big data amount plans to use it as reseller. Just use the contact us for that.