The following table shows the HTTP verbs, the scope, and the semantics for the methods that our new API must support. Each method is composed of an HTTP verb, a scope, and all the methods have well-defined meanings for all the resources and collections:
HTTP verb |
Scope |
Semantics |
|
Collection of message categories |
Retrieve all the stored message categories in the collection and return them sorted by their name in ascending order. Each category must include the full URL for the resource. Each category must include a list with all the details for the messages that belong to the category. The messages don't have to include the category in order to avoid repeating data. |
|
Message category |
Retrieve a single message category. The category must include the same information explained for each category when we retrieve a collection of message category. |
|
Collection of message categories |
Create a new message category... |