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 by an HTTP verb and a scope, and all the methods have well-defined meanings for all the resources and collections:
HTTP verb |
Scope |
Semantics |
GET |
Collection of notification categories |
Retrieve all the stored notification categories in the collection, sorted by their name in ascending order. Each notification category must include the full URL for the resource. In addition, each notification category must include a list containing all the details of the notifications that belong to the category. The notifications don't have to include the notification category in order to avoid repeating data. |
GET |
Notification category |
Retrieve a single notification category... |