Spectral Rulesets

Keeping track of Spectral Rulesets in the wild, helping you build better, more consistent APIs, via OpenAPI, AsyncAPI, JSON Schema, etc.

Design Rulesets (a.k.a "API Style Guide")

Helping you design and build better APIs.

• Adidas - Adidas were one of the first companies to release their API Style Guide in a written guide and a Spectral ruleset. Lots of good rules to try in here.
• APIs You Won't Hate - An opinionated collection of rules based on advice in the book APIs You Won't Hate community.
• Box - Lots of Custom Functions being used to enforce good practices that the Box API governance folks are interested in.
• Tranascom - Don't even think about using anything other than application/json.

Functional Rulesets

Helping the API conform to requirements of some particular standard or tooling requirements.

• AWS Gateway - Made by @andylockran to help avoid some of the quirks of AWS Gateway's OpenAPI compatibility.

Lint Rulesets

Helping you write better OpenAPI or AsyncAPI, but doesn't really tell you how to write the API itself.

• DigitalOcean - Keeping their OpenAPI nice and tidy, enforcing use of $ref (probably to minimize conflicts), naming conventions for Operation IDs, and all sorts of other handy OpenAPI tips.
• Nexmo - Communication company (now part of Vonage) have some handy rules like enforcing SemVer, requiring properties to have an example, and determining a preferred order of HTTP method definitions.
• Red Hat - Available as a npm module, this ruleset enforces the use of the companies preferred license, URL conventions for the whole path, and sets up consistent error responses across all APIs.
• Team Digitale - The Italian government have an interesting ruleset with great caching rules, helping teams avoid confusion like using both Cache-Control and Expires at once.
• VRChat Community - Very interesting use of the resolved: false option to make sure teams are using $ref instead of inlining things. Keep it DRY!
• VTex - This Digital Commerce Platform loves style guides. They have one for their React components, so why not have one for their many many Web APIs.
• Azure - Ruleset and complimentary style guide for creating OpenAPI 2 or 3 definitions of Azure services.
• SchwarzIT - Ruleset from the IT service provider behind Lidl, Kaufland and other companies from the Schwarz group.