Link Object: require referencing operation with unambiguous path template

[ralfhandl]

Assume paths /foo and /bar both have a Path Item Object that $ref the same external "complete" Path Item Object.

If a Link Object now operationRefs the get Operation Object within that external Path Item Object, which request should the client construct?

It could be both

• GET /foo or
• GET /bar

Proposal:

• Add restriction to Link Object that operationRef and operationId MUST NOT reference a reusable/multi-used Path Item Object
• Possibly: require that the operationRef value "goes through" a Paths Object