Reply
Highlighted

WAPI Version Changelog

SRees
Techie
Posts: 1
3734     0

consider me confused. WAPI docs (weridly distributed with the device and not on this website) say the WAPI and the NIOS version are entirely seperate.

The library I'm using runs against version 1.0. The documentation I'm using is against 1.4.1. These don't match, and I can find no changelog so I can bring the library up to 1.4.1, and no way to set the documentation back to 1.0. I think I've hit my first mistake with this setting the value in the host_ipv4 resource to "mac" instead of what I think is in 1.0, "mac_address."

The URL is /wapidoc so I tried messing with it to have a version string just like the API, but no dice.

The WAPI has a version string

I-Team Employee
Employee
Posts: 186
3735     0

The WAPI has a version string but the WAPIDOC doesn't. I agree that's a problem. 

there are really two problems here. In looking at this, I realize that our release notes don't go into details of what changed in the WAPI, they only say "there are new things in the REST API" and there is no change information in the published docs, either on the server or in the PDF version available on the support site. 

I just had a quick discussion on this with the product manager and he agrees we need to look into this. I'm going to be writing up some bugs on the problem and we're going to get together and talk about how this stuff should be set up. I think the idea of a versioned wapidoc is a good one but we need to look into whether that's possible. Detailed changes in the release notes would atleast give you a trail to follow on changes, and those should be in the notes. 

I don't have a good answer for you right now, but thanks for pointing this out. We'll talk about it and see what we can do to deal with these issues. 

 

WAPIDOC VERSION

CCox
Techie
Posts: 15
3735     0

If you pull the file https://<appliance>/wapidoc/index.html it seems to have a VERSION line that gives the information.

Is this consistent in all versions such that you could use it to find out what version of WAPI you are running on the appliance?

Thanks!

Craig

Example of /wapidoc/index.html:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

    <title>Infoblox WAPI documentation &mdash; Infoblox WAPI 1.4.2 documentation</title>

    <link rel="stylesheet" href="_static/default.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />

    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '',
        VERSION:     '1.4.2',

 

Re: WAPIDOC VERSION

GHorne Community Manager
Community Manager
Posts: 254
3735     0

The features are also backwards compatable. E.g NIOS 7.0 supports all WAPI versions 2.0 or lower.

 

so you can send queries to a NIOS 7.0 appliance using 

  /wapi/v2.0

  /wapi/v1.4

  etc

 

 

Specifying the version string in a query isn't required to match the version of NIOS, it is just a way of saying "I Intend to use features in version XXX of the WAPI, kick me an error if you don't support that version"

Showing results for 
Search instead for 
Do you mean 

Recommended for You