Skip to content
Snippets Groups Projects
Verified Commit c3aff6a5 authored by Jakob Moser's avatar Jakob Moser
Browse files

Reformat file

parent 6d7a3678
No related branches found
No related tags found
1 merge request!2Add agenda page
......@@ -51,7 +51,7 @@ paths:
### What's up with the weird path?
`/agendas/-/items` seems needlessly complicated, but there is a reason for that:
In REST, it is common to specify paths of the form `/{type}/<id>`. If `{type}` is a composite, i.e., consists of instances of a `{subtype}`, REST recommends a path of the form `/{type}/<id>/{subtype}/<id>` to address a particular instance of the subtype. For endpoints that return all instances of a particular type, `/{type}` is used. In case of composite instances, `/{type}/<id>/{subtype}` is used.
It felt wrong just to use `/items` to get all agenda items, as items is very unspecific. `/agenda-items` would have been possible, but a bit ugly. We therefore opted to model items as composites of an agenda, leaving us with `/agendas/<id>/items` as path to get all items.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment