Consistency request: Where should we put operationId?
In an attempt to align ourselves I would like to propose we collectively decide on the location of operationId in an API def:
The SwaggerHub example found here: https://swagger.io/docs/specification/paths-and-operations/ has it located above the summary and description tags:
but also beneath the description (my preference)
How do you do it and can we agree on a standard so designers don't have to think / doubt on its location?
Hi alex-savage
Thanks for the question. API standardization is one of the most important aspects of consistent API design and SwaggerHub has tools to help you do just that. At SmartBear, we tend to put the OperationID right after the method name and have created a custom rule to enforce this in SwaggerHub. You can view this rule and other in our public repo.
API Standardization: https://app.swaggerhub.com/help/organizations/api-standardization
GitHub Rules Library: https://github.com/SmartBear/swaggerhub-custom-rules-library
Feel free to try out these rule and tweak them as needed for your personal preference.
Hope this helps,
Tim