General Usage

User Agent

Please use a user-agent that is descriptive of your organization, for example:
curl --user-agent “example.com iHealth client v1.0”

API Versions

Specific versions of the API may be requested by sending the required version in the Accept: header. The content type must be specified as application/vnd.f5.ihealth.api[.v][+format], like so:
Accept: application/vnd.f5.ihealth.api.v1.0
Accept: application/vnd.f5.ihealth.api.v1.0

If you are using a browser, you may also add the version parameter to a request: api_version=1.0. If both an Accept header, and a version parameter are sent, in the case of conflict, the version parameter will take precedence. If no version is specified, then the most current version will be used.

Results Formatting

Where appropriate, the API can return results in either XML or JSON, or in the case of diagnostics, in XML, JSON, PDF, or CSV. There are two ways to request the format, using an Accept header, or a format specifier on the method call. If both an Accept header and a format specifier are used, in the case of a conflict, the format specifier will take precedence. If unspecified, XML will be returned. Example Accept format headers:
Accept: application/vnd.f5.ihealth.api.v1.0+xml # returns v1 in xml format
Accept: application/vnd.f5.ihealth.api.v1.0+json # returns v1 in json format
Accept: application/vnd.f5.ihealth.api # returns latest in xml format
Accept: application/vnd.f5.ihealth.api+json # returns latest in json format

If a URL format specifier is used, it must be used on the method call, before any URI query string parameters are sent, thus this is valid:
http://ihealth-api.f5.com/qkview-analyzer/api/qkviews/33/diagnostics.json?set=hit

While this is not:
https://ihealth-api.f5.com/qkview-analyzer/api/qkviews/33/diagnostics?set=hit.json

In addition, diagnostics may be retrieved in PDF or CSV format, using the appropriate headers:
Accept: application/vnd.f5.ihealth.api.v1.0+pdf # returns pdf format
Accept: application/vnd.f5.ihealth.api.v1.0+csv # returns csv format

or a format specifier on the method call:
http://ihealth-api.f5.com/qkview-analyzer/api/qkviews/33/diagnostics.pdf?set=hit
http://ihealth-api.f5.com/qkview-analyzer/api/qkviews/33/diagnostics.csv?set=hit

This is currently only available for the diagnostics call, and will trigger an error for any other method call.

<p>*The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.*</p>