Are there any CMS engines designed for creating re

2019-05-07 20:14发布

I'm in the process of creating a REST API for interfacing with a new SaaS site we're building and we need to document the API for use by a third-party iOS developer (plus other developers once the service goes public). Are there any existing database driven content management systems that facilitate building API documentation for this type of system?

I'm hoping for something more tailored than a generic wiki or wordpress build would provide.

edit: I should probably mention that our VPS is setup as a LAMP stack, so something PHP driven would be preferable.

Self-documenting is not a requirement, I'm actually wanting something more manual. I'd like to use the CMS as a designing platform for APIs that still need to be written as well.

2条回答
你好瞎i
2楼-- · 2019-05-07 20:47

Swagger has a "manual" way to enter your specs and generate documentation. See this answer here: https://stackoverflow.com/a/12085196/411229

Link to example project: https://github.com/wordnik/swagger-core/tree/master/samples/no-server

查看更多
放我归山
3楼-- · 2019-05-07 20:55

I/O Docs is an interactive documentation system running on nodejs. You generate a JSON schema of your API and it provides a HTML/JS site that describes your API and lets developers to play with it live from their browser.

Swagger is a specification for generating API docs and a framework for running your own documentation site.

While not a replacement for documentation Apigee ToGo would be a great addition to a more generic CMS for docs.

Sphinx isn't REST oriented but will generate documentation in general.

If you are building your API in Java Enunciate is something to look at as well. It will build documentation from JavaDocs.

查看更多
登录 后发表回答