Open johnbillion opened 3 years ago
Perhaps the entire set of REST API schema files need to be generated from OPTIONS requests to the actual endpoints, and this library provides transformation rules on a per-endpoint basis for adjustments.
For naming conventions, the HTTP verbs can't be used because POST can be used for both creating and updating.
Actually that might not be true, because to create an entity you POST to the collection endpoint and to update an entity you POST to the single item endpoint, and these have different schemas (although currently the collection schema is just an array of the single schemas).
The REST API schemas provided currently are only valid for reads (GET) and for the
view
andedit
contexts. This has some problems:view
andedit
contexts as they currently cover bothembed
contextIdeally separate schemas would be provided for each of the four request types (CRUD) and each of the three contexts (
view
,edit
, andembed
).What I don't want to do though is maintain a bunch of schemas for each endpoint that are all similar. This needs to either use partials or be automated somehow.