API Overview
Uploadcare API provides a single point of control for the entire infrastructure:
- Upload API — file uploads
- REST API — work with stored files
- CDN operations — on-the-fly image transformations
- File Uploader API — tweak behavior of our file uploader
Upload API
Key features:
- Direct uploading
- Multipart uploading
- Uploading via URL
- Secure uploading
Upload API powers our File Uploader.
REST API
Key features:
- Secure authorization
- File and file groups management
- Uploadcare projects management
- Video encoding and documents conversion
- Object recognition
CDN operations
Key features:
- Works on-the-fly
- Various image resizing methods, including smart crop
- Various image compression methods, including smart compression
- Fine control over colors
- Various image modifications
- File information
Here is the example of using our domain-specific language so you can get the idea right away:
https://ucarecdn.com/[UUID]/-/crop/200x300/center/
https://ucarecdn.com/[UUID]/-/resize/400x/-/effect/grayscale/
File Uploader API
This is a set of tools allowing you to adjust our File Uploader behavior and implement advanced workflows like moderating uploaded content or playing with the file uploader appearance. You can also use certain methods of the API without the file uploader, as standalone components.
Versioning
When we introduce backward-incompatible changes into File Uploader and REST API, we release new major versions. Once published, such versions are supported for a limited time period. This section combines versions, their publishing dates, and support terms.
The support length for each new release of Uploadcare File Uploader and REST API is 2 years. The two-year support term for current versions starts when we release the new ones. We will update this document, our changelog, and notify you via email about new releases.
The latest versions are:
- Uploadcare File Uploader: 3.7.7
- REST API: 0.5
File Uploader Versioning
Version | Date Published | Supported Until |
---|---|---|
3.x | 28 Jun 2017 | TBD |
2.x | 20 Feb 2015 | 1 Jan 2020 |
1.x | 21 Mar 2014 | 1 Jun 2019 |
0.x | 6 Sep 2012 | 1 Jun 2019 |
Note, you will still be able to use any file uploader version after its support term. However, you will be acting at your own risk.
The history of file uploader 3.x and 2.x changes can be found on GitHub. To migrate from 2.x to 3.x, check out this migration guide.
REST API Versioning
Version | Date Published | Available Until |
---|---|---|
0.5 | 1 Apr 2016 | TBD |
0.4 | 13 Jun 2015 | 1 Sep 2019 |
0.3 | 11 Jun 2013 | 1 Sep 2019 |
0.2 | 7 Jun 2012 | 1 Sep 2019 |
0.1 | 31 May 2012 | 1 Feb 2019 |
Undefined | 31 May 2012 | 1 Sep 2019 |
Note, you won’t be able to use any API version after its support term. Requests to deprecated API versions will return error messages.