@snyk/sweater-comb
Advanced tools
Sweats the small stuff, so you don't have to. OpenAPI linting rules for Snyk APIs.
Sweats the small stuff, so you don't have to. OpenAPI linting rules for Snyk APIs.
At Snyk, we're starting an API program that aims to maximize the value we provide to developers and the extensibility of our platform through our APIs.
Such an API needs some guardrails to stay cohesive, consistent and "unsurprising" to its consumers, as the platform scales in the number of concepts it provides and the number of teams delivering them.
Sweater Comb helps provide some of those guardrails with automation, initially by applying custom Optic CI rules to our OpenAPI specifications.
Read more about our API program here.
JSON API is a standard for representing resources as JSON data.
Generally, our API adheres closely to the JSON API specification. JSON API: The Good Parts describes how we adapted JSON API into our API standards.
We found JSON API to be an excellent starting point for a resource-based API, formatting and structuring JSON data in requests and responses. Leveraging JSON API's opinionated choices enabled us to focus more on designing and building the actual content of our API.
What does JSON API look like? What do I need to know to get started building a resource in 5 minutes? Let’s cover the basics first; you can always refer to the JSON API specification for a deeper understanding of specific details.
Read more about our experiences with JSON API here.
How we version our API, and more to the point, API requirements necessary in order to implement our versioning scheme.
Read more about how we version here.
Everything else; other requirements we found necessary to keep our API nice and neat.
TODO
FAQs
“Sweats the small stuff, so you don’t have to. OpenAPI linting rules for Snyk APIs.”
The npm package @snyk/sweater-comb receives a total of 3,714 weekly downloads. As such, @snyk/sweater-comb popularity was classified as popular.
We found that @snyk/sweater-comb demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Bun 1.2 enhances its JavaScript runtime with 90% Node.js compatibility, built-in S3 and Postgres support, HTML Imports, and faster, cloud-first performance.
Security News
Biden's executive order pushes for AI-driven cybersecurity, software supply chain transparency, and stronger protections for federal and open source systems.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.
