Need advice about which tool to choose?Ask the StackShare community!

Apiary

223
297
+ 1
108
Swagger UI

1.8K
1.5K
+ 1
204
Add tool

Apiary vs Swagger UI: What are the differences?

Apiary: Integrated API documentation, prototyping and testing. It takes more than a simple HTML page to thrill your API users. The right tools take weeks of development. Weeks that apiary.io saves; Swagger UI: dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation. Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API.

Apiary and Swagger UI belong to "Documentation as a Service & Tools" category of the tech stack.

"Easy to use" is the primary reason why developers consider Apiary over the competitors, whereas "Open Source" was stated as the key factor in picking Swagger UI.

According to the StackShare community, Swagger UI has a broader approval, being mentioned in 203 company stacks & 101 developers stacks; compared to Apiary, which is listed in 44 company stacks and 18 developer stacks.

Advice on Apiary and Swagger UI
Needs advice
on
PostmanPostmanApiaryApiary
and
Swagger UISwagger UI

From a StackShare Community member: "I just started working for a start-up and we are in desperate need of better documentation for our API. Currently our API docs is in a README.md file. We are evaluating Postman and Swagger UI. Since there are many options and I was wondering what other StackSharers would recommend?"

See more
Replies (3)
Jagdeep Singh
Tech Lead at ucreate.it · | 8 upvotes · 244.3K views

I use Postman because of the ease of team-management, using workspaces and teams, runner, collections, environment variables, test-scripts (post execution), variable management (pre and post execution), folders (inside collections, for better management of APIs), newman, easy-ci-integration (and probably a few more things that I am not able to recall right now).

See more

I use Swagger UI because it's an easy tool for end-consumers to visualize and test our APIs. It focuses on that ! And it's directly embedded and delivered with the APIs. Postman's built-in tools aren't bad, but their main focus isn't the documentation and also, they are hosted outside the project.

See more
Sadik Ay
Recommends
PostmanPostman

I recommend Postman because it's easy to use with history option. Also, it has very great features like runner, collections, test scripts runners, defining environment variables and simple exporting and importing data.

See more
Get Advice from developers at your company using Private StackShare. Sign up for Private StackShare.
Learn More
Pros of Apiary
Pros of Swagger UI
  • 28
    Easy to use
  • 19
    Free to use
  • 12
    Traffic inspector
  • 11
    Free
  • 10
    Collaboration
  • 7
    Mock API
  • 4
    Dashboard
  • 3
    Customization
  • 2
    30 Days Trial
  • 2
    Documentation
  • 2
    Access Control
  • 2
    Validate API Documentation
  • 1
    API explorer
  • 1
    Clean syntax
  • 1
    Provisioning
  • 1
    Shared API blueprint templates
  • 1
    Github integration helps with collaboration
  • 1
    Code auto-generation
  • 47
    Open Source
  • 34
    Can execute api calls from the documentation
  • 29
    Free to use
  • 19
    Customizable
  • 14
    Easy to implement in .Net
  • 13
    Mature, clean spec
  • 11
    API Visualization
  • 9
    Coverage
  • 6
    Scaffolding
  • 6
    Easy to use
  • 5
    Vibrant and active community
  • 4
    Elegant
  • 3
    Adopted by tm forum api
  • 2
    Clear for React
  • 1
    Api
  • 1
    Can deploy API to AWS API Gateway and AWS Lambda

Sign up to add or upvote prosMake informed product decisions

Cons of Apiary
Cons of Swagger UI
    Be the first to leave a con
    • 3
      Need to learn YAML and RAML
    • 2
      Documentation doesn't look that good
    • 1
      Doesn't generate code snippets in different languages
    • 1
      You don’t actually get in-line error highlighting
    • 1
      Does not support hypermedia

    Sign up to add or upvote consMake informed product decisions