Resource types / patterns for Path Item Objects #588

OData services mainly consist of "entity sets" which are collections of "entities" that are uniquely identified by their key property values within their entity set.

So a "read-only entity set" will support

• GET on the set, with a predefined set of query options for paging ($top, $skip), filtering, sorting, free-text search, ...
• GET on the individual entity by specifying the entity set plus the key property values

And "updatable entity sets" will in addition support

• POST on the set to add new entities
• PATCH and DELETE on individual entities

Basically an OData-aware client only needs the entity set name, the structure definition for each entity, and the "readonly/updatable" information to know the path templates and expected request and response bodies, allowed headers, possible response codes etc.

Spelling this out for OData-unaware clients takes a lot of highly repetitive content in the /paths section.

It would be great to have resource types or parameterized templates/patterns for Path Item objects that would allow to specify

/Products:
ReadOnlyEntitySetOfType
{ $ref: #/definitions/Product }
/People:
UpdatableEntitySetOfType
{ $ref: #/definitions/Person }

Please note that we foresee (well, actually have :-) services with dozens or hundreds of entity sets, so this would significantly reduce the size of the OpenAPI documents.