Material vs Swagger UI: What are the differences?
Material belongs to "Mobile Prototyping & Interaction Design Tools" category of the tech stack, while Swagger UI can be primarily classified under "Documentation as a Service & Tools".
Material is an open source tool with 11K GitHub stars and 1.2K GitHub forks. Here's a link to Material's open source repository on GitHub.
Clever, triGo GmbH, and Hootsuite are some of the popular companies that use Swagger UI, whereas Material is used by Pardel Technologies, Working Minds, and Contratobook. Swagger UI has a broader approval, being mentioned in 203 company stacks & 101 developers stacks; compared to Material, which is listed in 8 company stacks and 8 developer stacks.
What is Material?
What is Swagger UI?
Need advice about which tool to choose?Ask the StackShare community!
Why do developers choose Material?
Sign up to add, upvote and see more prosMake informed product decisions
What are the cons of using Material?
What are the cons of using Swagger UI?
Sign up to get full access to all the companiesMake informed product decisions
Sign up to get full access to all the tool integrationsMake informed product decisions
We just launched the Segment Config API (try it out for yourself here) — a set of public REST APIs that enable you to manage your Segment configuration. A public API is only as good as its #documentation. For the API reference doc we are using Postman.
Postman is an “API development environment”. You download the desktop app, and build API requests by URL and payload. Over time you can build up a set of requests and organize them into a “Postman Collection”. You can generalize a collection with “collection variables”. This allows you to parameterize things like
workspace_name so a user can fill their own values in before making an API call. This makes it possible to use Postman for one-off API tasks instead of writing code.
Then you can add Markdown content to the entire collection, a folder of related methods, and/or every API method to explain how the APIs work. You can publish a collection and easily share it with a URL.
This turns Postman from a personal #API utility to full-blown public interactive API documentation. The result is a great looking web page with all the API calls, docs and sample requests and responses in one place. Check out the results here.
Postman’s powers don’t end here. You can automate Postman with “test scripts” and have it periodically run a collection scripts as “monitors”. We now have #QA around all the APIs in public docs to make sure they are always correct
Along the way we tried other techniques for documenting APIs like ReadMe.io or Swagger UI. These required a lot of effort to customize.
Writing and maintaining a Postman collection takes some work, but the resulting documentation site, interactivity and API testing tools are well worth it.
Two weeks ago we released the public API for Checkly. We already had an API that was serving our frontend Vue.js app. We decided to create an new set of API endpoints and not reuse the already existing one. The blog post linked below details what parts we needed to refactor, what parts we added and how we handled generating API documentation. More specifically, the post dives into:
- Refactoring the existing Hapi.js based API
- API key based authentication
- Refactoring models with Objection.js
- Validating plan limits
- Generating Swagger & Slate based documentation