Requiring that all operational unique identifiers meets the policy standards.
Unique Identrifiers for API Operations
Rules
OpenAPI Operations Operation Ids Error
Operation identifiers provide a unique way to identify each individual API, which then used for SDK generation and other automation
OpenAPI Operations Operation Ids Info
Operation identifiers provide a unique way to identify each individual API, which then used for SDK generation and other automation
OpenAPI Operations Operation Ids Camel Case Error
Operation identifiers provide a unique way to identify each individual API, and requiring them to have consistent casing reduces friction when generating SDKs and automating around APIs
OpenAPI Operations Operation Ids Camel Case Info
Operation identifiers provide a unique way to identify each individual API, and requiring them to have consistent casing reduces friction when generating SDKs and automating around APIs
Strategies
Operations Must Be Useful and Consistent
All individual API operations must be useful and follow consistent Internet, industry, and enterprise standards, providing a simple and relevant HTTP API operation that does one thing and does it w...
Lifecycle
design_services Design Design
Design is where the human experience of an API is won or lost. I work design-first, shaping the paths, schema, errors, and naming in the contract before development begins, so that consistency is b...