Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Are there any CMS engines designed for creating reference documentation for a REST API? [closed]

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.

like image 811
ChiperSoft Avatar asked Jan 18 '23 19:01

ChiperSoft


1 Answers

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.

like image 162
abraham Avatar answered Jan 30 '23 20:01

abraham