Question

Let’s say I have a RESTful, hypertext-driven service that models an ice cream store. To help manage my store better, I want to be able to display a daily report listing quantity and dollar value of each kind of ice cream sold.

It seems like this reporting capability could be exposed as a resource called DailyReport. A DailyReport can be generated quickly, and there doesn’t seem to be any advantage to actually storing reports on the server. I only want a DailyReport for some days, other days I don’t care about getting a DailyReport. Furthermore, storing DailyReports on the server would complicate client implementations, which would need remember to delete reports they no longer need.

A DailyReport is transient; its representation can be retrieved only once. One way to implement this would be to offer a link “/daily-reports”, a POST to which will return a response containing a DailyReport representation listing the information for that day’s sales.

Edit: Let’s also say that I really do want to do a POST request. A DailyReport has many different options for creating a view such as sorting ice cream types alphabetically, by dollar value – or including an hourly breakdown – or optionally including the temperature for that day – or filtering out certain ice cream types (as a list). Rather than using query parameters with a GET, I’d rather POST a DailyReport representation with the appropriate options (using a well-defined custom media type to document each option). The representation I get back would display my options along with the report itself.

Is this the correct way to think about the problem, or should some other approach be used instead? If correct, what special considerations might be important when implementing the DailyReport resource? (For example, it probably wouldn’t be appropriate to set the Location header when returning after a POST request).

Answer 1

If you want to make daily reports for past days available, you could implement it as a GET to /daily_reports/2009/08/20. I agree with John Millikin that a POST is unnecessary here – there’s no need for something like this to be a user-creatable resource.

The advantage of making the report for each day available as its own URI is cacheability.

EDIT: A good solution might be to merge the two answers, making daily_report/ a no-cache representation of the current day’s data and daily_reports/yyyy/mm/dd a cacheable representation of a full day’s data.