2013-07-25 We are working on REST API v. 1.1
Version 1.0 of API is already used in some integrations, including the Salesforce extension for MailUp. We are still optimizing it for big volumes of data (this is the main reason for the BETA tag) and, at the same time, we are working to optimize filtering and ordering capabilities. Some changes related to new features will affect backward compatibility, hence to we have decided to release version “1.1” on a different endpoint. Expected release date is within September 2013, at that time 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 can continue to use it, migration to version 1.1 is anyway recommended if you want to benefit of the new features. Anyway, 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 of the MailUp REST API project, next improvements are expected to be applied to version 1.1 without backward compatibility problems.Here below there is a list of new features that will be available as soon as version 1.1 will be available:
- Get requests: all the HTTP GET requests that returns a collection of items will have a total counter and pagination info alongside with the Items collection itself;
- Default pagination values: all the request that return collection of items will be paginated by default with a page size of 20…no more entire collection by default, 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 developers filter collections “as they want” (ex. filter by=” [idColor==’Blue’ || idColor.Contains(‘Azure’)] && [id <= 30 && id != 10] ”)
2013-07-15 Documentation of REST API v. 1.0 officially released
Documentation is now public.