Is there any API to create a similar Google Directory API service?

1

I find the Google Directory API very interesting to gather documentation and test environment in an easy, objective and well-organized way.

I wonder if there are any similar plugins that can be added to a Java application to automatically generate this environment. To be clearer I would cite Javadoc. Based on the annotations and comments he is able to generate the documentation. This would already be a good part of the content we can find in the Directory API. Already the testing environment could for the REST functions would depend on the REST notation, identify the URL of the server and mount the request URL. The Javadoc does not contemplate everything.

What I just wanted to do was mount a private Directory API , where it contained the documentation for my project.

Does anyone know if this is ready somewhere or if it really needs to be created at hand? If it exists, what program or plugin is used to do this?

    
asked by anonymous 07.08.2015 / 19:27

2 answers

0

Maybe the Maven site builder can help you with this task, because with it you can generate sites with project documentation and additional items at a glance:

Maven - Creating a Site

    
07.08.2015 / 19:32
0

ApiDoc is a library that can be used to generate the documentation of the rest services.

This tool, in addition to having documentation support, also has the sandbox which is a test environment that can be used to test your own calls.

I used it in Symfony, but it can be used in other frameworks or even used without a framework, its use is based on Annotations, through "comments" you can document your rest and also the testing environment.

The library is very complete and has good documentation, for more information about the library, just go to apiDoc website , if you are using symfony, you can use the NelmioApiDocBundle .

The library also allows customization of the template, for creating a custom layout.

    
15.08.2016 / 23:25