2013-07-25
...
Filtering and ordering coming in v1.1
How the REST API is evolving
We're already at work on a new version of the REST API.
Version 1.0 of the MailUp REST API is already being used in some integrations, including the MailUp App for Salesforce extension for MailUp. We are still optimizing it for big volumes of data (this is the main reason for the
tag) and, at the same time, we are working to optimize introduce additional filtering, paging, and ordering capabilities in version "1.1".Status colour Yellow title BETA
Some changes in the API related to these new features will affect backward compatibility, hence to we have decided to release version “1.1” on and therefore version 1.1 will be released with a different endpoint.
Expected release date is within September 2013, at that time the for v1.1 is some time in September 2013. When version 1.1 is released:
- The MailUp REST API will be OUT OF BETA for both versions 1.0 and 1.1
...
- If you are using version 1.0, you
...
- will be able to continue using it
- Migrating to v1.1 is
...
- recommended if you want to benefit
...
- from the new features
...
We don't expect that you will be frequently asked to switch endpoint, : please consider this as a rare case that is due to the start-up young age of the MailUp REST API project, next . Future improvements are expected to be applied to version 1.1 without backward compatibility problems.Here below there
New features in v1.1
Here is a list of new features that will be available as soon as version 1in v1.1 will be available:
- Get requests: all the HTTP GET requests that returns return a collection of items will have a total counter and pagination info alongside with the Items collection itself;
- Default pagination values: all the request requests that return a collection of items will be paginated by default with a page size of 20…no more entire collection by default,
- Entire collection: if you want the entire collection you’ll have to setup a particular value for pageSize or pageNumber;
- Ordering: with the new release it will be possible to specify complex ordering filters on multiple fields and - if needed - different sorting directions (ex. order by=” id, category-id desc; title asc ”)
- Filtering: new complex query parser will be added to make allow developers to filter collections “as they want” wish” (ex. filter by=” [idColor==’Blue’ || idColor.Contains(‘Azure’)] && [id <= 30 && id != 10] ”)
...
2013-07-15 Documentation of REST API
...
v1.
...
0 officially released
Documentation The MailUp REST API documentation is now public.
...