The Keyhole Labs team is excited to announce that GrokOla now offers Swagger integration.
GrokOla users can now upload Swagger JSON files into GrokOla to have all API documentation centralized, searchable, and accessible from within their private GrokOla instance.
This is the example Swagger UI Petstore server loaded into and accessible from GrokOla. Info: http://petstore.swagger.io/.
Additionally, there an integration API that allows Swagger JSON to be uploaded automatically to GrokOla with a RESTful API. This allows continuous integration systems to update API documentation during the build process, then updating GrokOla.
From the GrokOla Admin panel, users can quickly upload any Swagger JSON files or set up a Swagger Access Token.
Swagger is a popular open source tool that stores API documentation. According to its documentation:
With a Swagger-enabled API, you get interactive documentation, client SDK generation and discoverability.
The goal of Swagger™ is to define a standard, language-agnostic interface to REST APIs which allows both humans and computers to discover and understand the capabilities of the service without access to source code, documentation, or through network traffic inspection. When properly defined via Swagger, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.
Our development team has found Swagger immensely helpful in quickly and correctly documenting RESTful APIs. Now, with this integration, GrokOla users can now have all of their Swagger benefits right from their GrokOla wiki dashboard.
Just Another Great Feature of GrokOla
GrokOla is a web-based wiki tool for development teams that supports knowledge transfer through a Q&A-driven platform. Users can create, query, and share wiki content & mockups with their team from anywhere via its web-based or mobile platform.
Code-Sensitive Wiki
GrokOla provides a centralized wiki for the “Tribal Knowledge” needed by your team. Code solutions and APIs are documented using simple markdown syntax and language-sensitive editors.
MockOla
MockOla is a rapid wireframing tool that allows users to easily create user interface mockups. Users lay out simple user interfaces configurations for web, tablet, and mobile application using a drag-and-drop element editor. The key to MockOla is the simplicity of use, lending itself to quick mockup creation, sharing, feedback, and movement to the next iteration.
Educational Resources
Educational resources are added and updated daily, to include self-paced technology courses, language and tool primers (like Backbone.js, Spring, JavaScript and Node.js), and formal development presentations. Public material is viewable from the mobile application free of charge. Download GrokOla Mobile for free in the Google Play Store or Apple App Store, or by using the following direct links: Play Store and App Store.
GrokOla was developed by Keyhole Labs, a division of Keyhole Software. GrokOla is available free of charge to all current Keyhole Software enterprise clients, and to other development teams for a fee. For more information, visit GrokOla.com.
Note: Swagger is not affiliated with Keyhole Software, but the Swagger Specification was been donated to the Open API Initiative (OAI) and has been renamed to the OpenAPI Specification. We love open source!
| Reference: | Give Enterprise APIs Visibility With Swagger And GrokOla from our JCG partner Lauren Fournier at the Keyhole Software blog. |
