{"id":5306,"date":"2021-04-07T14:56:28","date_gmt":"2021-04-07T21:56:28","guid":{"rendered":"https:\/\/blogs.infoblox.com\/?p=5306"},"modified":"2022-10-20T14:34:07","modified_gmt":"2022-10-20T21:34:07","slug":"taking-wapi-documentation-to-the-next-level-using-swagger","status":"publish","type":"post","link":"https:\/\/www.infoblox.com\/blog\/community\/taking-wapi-documentation-to-the-next-level-using-swagger\/","title":{"rendered":"Taking WAPI Documentation to the Next Level using Swagger"},"content":{"rendered":"

Introduction<\/b><\/h3>\n

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.<\/span><\/p>\n

Reasons to use Swagger<\/b><\/h3>\n
    \n
  1. It is comprehensible for developers and non-developers<\/span><\/li>\n
  2. It is human-readable and machine-readable<\/span><\/li>\n
  3. It is easy to use<\/span><\/li>\n
  4. One does not need to have coding knowledge to use it<\/span><\/li>\n<\/ol>\n

    Infoblox WAPIs<\/b><\/h3>\n

    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.\u00a0 These do not depend on any programming language. <\/span>\u00a0<\/span><\/p>\n

    What\u2019s new in WAPIs with NIOS 8.6?<\/b><\/h3>\n

    NIOS 8.6 comes with a new WAPI version v2.12 and has added support for v2.11.1 released with NIOS 8.5.1. Objects added in the new WAPI versions are:\u00a0<\/span><\/p>\n

      \n
    1. WAPI v2.12:<\/b>\u00a0 \u201cdiscovery:credentialgroup\u201d<\/span><\/li>\n
    2. WAPI v2.11 and v2.11.1:<\/b> \u201cdiscovery:sdnnetwork\u201d, \u201cparentalcontrol:subscriberrecord\u201d, \u201cpxgrid:endpoint\u201d, \u201cthreatanalytics:analytics_whitelist\u201d<\/span><\/li>\n<\/ol>\n

      Infoblox WAPI documentation using Swagger<\/b><\/h3>\n

      This solution uses Swagger to give the Infoblox WAPIs a visual representation. Swagger supports the Open-API-Specification (OAS) and uses the definition to create a user-interface for visualization of the APIs making it easy for the user to understand and work with defined APIs. The solution accepts the WAPI version as a parameter and documents all the API-endpoints for the selected WAPI version.<\/span><\/p>\n

      Swagger definition for Infoblox WAPIs makes it really easy to work with the APIs.\u00a0<\/span><\/p>\n

      All WAPI objects till version v2.12 are documented. The Swagger user-interface for Infoblox WAPIs\u00a0 looks like this:<\/span><\/p>\n

      \"\"<\/p>\n

      Why do you need to use this solution?<\/b><\/h3>\n
        \n
      1. No need to know any curl commands or programming language-specific constructs to try out WAPIs<\/span><\/li>\n
      2. No need to download any tool like Postman or Insomnia<\/span><\/li>\n
      3. It serves as a playground to understand the structure and working of the APIs<\/span><\/li>\n
      4. It provides a \u201ctry it out\u201d feature that enables users to familiarize with the APIs<\/span><\/li>\n<\/ol>\n

        What\u2019s new with Swagger v3?<\/b><\/h3>\n
          \n
        1. Added support for WAPI version v2.12 released along with NIOS 8.6.<\/span><\/li>\n
        2. Added support for v2.11.1 (minor WAPI version released with NIOS 8.5.1).\u00a0<\/span><\/li>\n
        3. Updated GUI with SSL verification during documentation generation.<\/span><\/li>\n
        4. Automated the definition generation for all supported WAPI versions.<\/span><\/li>\n<\/ol>\n

          Demo Video<\/b><\/h3>\n

          You can watch this video for a quick demo of Infoblox DDI (NIOS) integration with Swagger.<\/span><\/p>\n

           <\/p>\n