≈ the.bay.news

operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

DEV Community
operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable
operationId becomes the method name in every generated SDK and tags become the namespace and the docs sidebar, yet most specs treat both as afterthoughts. Duplicate ids, verb-first names, and a unique tag per endpoint produce unusable clients and a wall of operations. Here is a naming system...

0 comments

Sign in to join the discussion — your thebay.events account works here.

No comments yet.