Multi-get

In some cases, you may already know the URI's for several objects of the same endpoint that you would like to request. Instead of making several separate requests to the same endpoint, you can use a feature called multiget to retrieve all of the objects in a single request.

For example, fetching user data for users cmac and onethumb can be done with the following two requests:

GET /api/v2/user/cmac HTTP/1.1
Host: www.smugmug.com
Accept: application/json

This same data can be requested using a single HTTP request, like below (_filteruri is used to condense the response for presentation purposes only):

GET /api/v2/user/cmac,onethumb?filteruri=UserProfile HTTP/1.1
Host: www.smugmug.com
Accept: application/json

Note how the LocatorType has changed to Objects and the value of Response.User is now an array containing multiple User objects.

Multiget also supports being used with actions, expansions, and filters.