vsethia/infoblox-wapi-swagger repository overview

                        	      Copyright 2021                                            
                  	Author: Vedant Sethia <[email protected]>                         
	For any issues/suggestions please write to [email protected] , [email protected]           

⁠WAPI Documentation using Swagger

⁠Swagger

Swagger is an open-source software framework backed by a large ecosystem of tools that helps developers design, build, document, and consume RESTful web services. While most users identify Swagger by the Swagger UI tool, the Swagger toolset includes support for automated documentation, code generation, and test-case generation. Sponsored by SmartBear Software, Swagger has been a strong supporter of open-source software, and has widespread adoption.

• swagger-ui-dist⁠ is a dependency-free module that includes everything you need to serve Swagger UI in a server-side project, or a single-page application that can't resolve npm module dependencies.

⁠Open-API Specification

The OpenAPI Specification (OAS) defines a standard, language-agnostic interface to RESTful 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, a consumer can understand and interact with the remote service with a minimal amount of implementation logic.

An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.

⁠Infoblox RESTful APIs

The Infoblox WAPI is an interface based on REST (REpresentational State Transfer). It uses HTTP methods and supports the primary or most-commonly-used HTTP verbs: POST, GET, PUT, and DELETE. These correspond to create, read, update, and delete (or CRUD) operations, respectively. It supports input and output in JSON and XML. All API calls are encrypted using SSL/TLS and authenticated using HTTP basic authentication. These do not depend on any programming language.

⁠Documentation

⁠Pre-requisites

• CORS Plugin
• Connectivity between Grid master and Host

⁠Docker

You can pull a pre-built docker image of the Infoblox-Swagger-UI directly from Docker Hub:

      docker pull vsethia/infoblox-wapi-swagger:v3
      docker run -p <PORT NO>:80 vsethia/infoblox-wapi-swagger:v3

This will start apache with Swagger UI on the specified PORT NO.

⁠Instructions

After accessing "home.php":

• Enter the Grid Master IP-Address/FQDN and corresponding credentials on the homepage.
• Select the WAPI version.
• Click on the button to view the Swagger-UI

⁠Maintenance

Date: April 6, 2021

• Added support for WAPI version v2.12 and v2.11.1 released along with NIOS 8.6.
• Fixed bugs related to SSL verification during documentation generation.
• Automated the definition generation for WAPI v2.7-v2.12.