4

I am wondering if anyone can point me to which Web-Api Help Generator I should use.

I found this post but it is already a year old and seems to be outdated.

I think ApiExplorer is now Web API Help.

The post also talks about Swagger which from some demos looks a lot nicer and seems like you can do like post requests and such but I am unsure if it still in development as it's been like a year since the last update.

Anyone have any experience with either of them?

1 Answer 1

1

The "Web API Help Page" package (Microsoft.AspNet.WebApi.HelpPage) is built on top of ApiExplorer.

  • Web API Help Page generates documentation pages and adds them to your project.
  • ApiExplorer gives you a lower-level API that just gives you the API descriptions, which you can use to create documentation.

See: http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages

I haven't used Swagger. From the readme, it's also built on top of ApiExplorer.

Sign up to request clarification or add additional context in comments.

Comments

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.