RESTful API v2.1 (rev8)

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X POST \
    -u user:pword \
    "https://your.statseeker.server/api/v2.1/group/?indent=3" \
    -d '{"data":[{"name":"Group1"}]}' 

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X POST \
    -u user:pword \
    "https://your.statseeker.server/api/v2.1/group/?indent=3" \
    -d "{\"data\":[{\"name\":\"Group1\"}]}" 

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1"

#!/usr/bin/python 

# imprt urllib for handling the https connection
# import base54 for encoding the authentication details
# import json for parsing the response data
import urllib2, base64, json

# specify the api endpoint to be used
endpoint = "https://your.statseeker.server/api/v2.1/"

# encode  credentials
user = "username"
pword = "password"
base64string = base64.encodestring('%s:%s' % (user, pword)).replace('\n', '')

# build the request
request = urllib2.Request(endpoint)
request.add_header("Accept", "application/json")
request.add_header("Content-Type", "application/json")
request.add_header("Authorization", "Basic %s" % base64string)   

# send request, collect response, optionally format response for display on screen
response = urllib2.urlopen(request)
data = json.load(response)
formatted_data = json.dumps(data, indent=3, sort_keys=True)
print(formatted_data)

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'

# api root endpoint
$uri = 'https:/your.statseeker.server/api/v2.1/'

# api user credentials
$user = 'username'
$pword = 'password'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# send request
response = RestClient::Request.new({
      method: :get,
      url: $uri + $rspFormat,
      user: $user,
      password: $pword,
    }).execute
	
# output response to screen
puts "#{response.to_str}"

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/cdt_device/?fields=name,id,community,ipaddress,snmp_version&groups=AU_Servers&indent=3"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_device/"

# specify fields to be returned and filters to use
getFields = "?fields=name,id,community,ipaddress,snmp_version&groups=AU_Servers"

# optional response formatting
rspFormat = "&indent=3"

# set URL to be used
url = rootUri + targetUri + getFields + rspFormat

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_device/'

# set fields to return
$fields = '?fields=name,id,community,ipaddress,snmp_version&groups=AU_Servers'


# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.172",
            "name": "Brisbane-Server1",
            "community": "public",
            "id": 551
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.180",
            "name": "Brisbane-Server2",
            "community": "public",
            "id": 552
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.186",
            "name": "Sydney-Server1",
            "community": "public",
            "id": 555
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.187",
            "name": "Sydney-Server2",
            "community": "public",
            "id": 556
          },
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.194",
            "name": "Melbourne-Server1",
            "community": "public",
            "id": 557
          }
        ],
        "type": "cdt_device",
        "data_total": 5
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496188135
  },
  "links": [
    {
      "link": "/api/v2.1/cdt_device?fields=name,id,community,ipaddress,snmp_version&groups=AU_Servers&indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/cdt_device/describe",
      "rel": "describedby"
    },
    {
      "link": "/api/v2.1/cdt_device/551",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/552",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/555",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/556",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/557",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X POST \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"data":[{"name":"B1"},{"name":"B2"}]}' 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# api user credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "group/"

# optional response formatting
rspFormat = "?indent=3"

# set URL to be used
url = rootUri + targetUri + rspFormat


# data
data = json.dumps({"data":[{"name":"B1"},{"name":"B2"}]})

# send request 
r = requests.post(url, headers=headers, auth=(user, pword), data=data)

# print response to the screen
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https:/your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'group/'


# set payload in json format
$group1 = {
   :name => 'B1',
 }
$group2 = {
   :name => 'B2',
 }
$jData = '{"data":[' + $group1.to_json + ',' + $group2.to_json + ']}'

# send request
response = RestClient::Request.execute(
	:method => :post,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "name": "B1",
            "id": 46458
          },
          {
            "name": "B2",
            "id": 46459
          }
        ],
        "type": "group",
        "data_total": 2
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496190459
  },
  "links": [
    {
      "link": "/api/v2.1/group?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group/describe",
      "rel": "describedby"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"fields":{"name":{"field":"name","filter":{"query":"=\u0027B1\u0027"}}},"data":[{"name":"Bangalore1"}]}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/group/"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# data contains both 'fields' key and a 'data' key
data = json.dumps({"fields":{"name":{"field":"name","filter":{"query":"='B1'"}}},"data":[{"name":"Bangalore1"}]})

# send request and 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https:/your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'group/'


# set payload in json format
$jData = '{"fields":{"name":{"field":"name","filter":{"query":"=\'B1\'"}}},"data":[{"name":"Bangalore1"}]}'

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496190511
  },
  "links": [
    {
      "link": "/api/v2.1/group?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group/describe",
      "rel": "describedby"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X DELETE \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/?indent=3" \ 
	-d '{"fields":{"name":{"field":"name","filter":{"query":"LIKE \u0027B_\u0027"}}}}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/group/"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# data
data = json.dumps({"fields":{"name":{"field":"name","filter":{"query":"LIKE 'B_'"}}}})

# send request and 
r = requests.delete(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'group/'


# set payload in json format
$jData = '{"fields":{"name":{"field":"name","filter":{"query":"LIKE \'B_\'"}}}}'

# send request
response = RestClient::Request.execute(
	:method => :delete,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496190845
  },
  "links": [
    {
      "link": "/api/v2.1/group?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group/describe",
      "rel": "describedby"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword \
	"https://your.statseeker.server1/api/v2.1/user/describe/?indent=3"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/user/describe/"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'user/describe/'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
)

#output response to screen
    puts "#{response.to_str}"

{
{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "fields": {
          "tz": {
            "datatype": "string",
            "description": "User time zone",
            "title": "Time Zone"
          },
          "name": {
            "datatype": "string",
            "description": "User name",
            "title": "Name"
          },
          "auth": {
            "datatype": "string",
            "description": "User authentication method",
            "title": "Authentication method"
          },
          "email": {
            "datatype": "string",
            "description": "User email address",
            "title": "Email"
          },
          "api": {
            "datatype": "string",
            "description": "User API access permission",
            "title": "API Access"
          },
          "password": {
            "datatype": "string",
            "description": "User password",
            "title": "Password"
          },
          "id": {
            "datatype": "integer",
            "description": "User Identifier",
            "title": "ID"
          }
        },
        "commands": {
          "delete": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": null
          },
          "add": {
            "valid_fields": null,
            "valid_data": {
              "tz": {
                "required": false
              },
              "name": {
                "required": true
              },
              "auth": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "email": {
                "required": false
              }
            }
          },
          "describe": {
            "valid_fields": null,
            "valid_data": null
          },
          "update": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": {
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "tz": {
                "required": false
              },
              "email": {
                "required": false
              },
              "auth": {
                "required": false
              }
            }
          },
          "get": {
            "valid_fields": {
              "tz": {
                "required": false
              },
              "name": {
                "required": false
              },
              "auth": {
                "required": false
              },
              "email": {
                "required": false
              },
              "api": {
                "required": false
              },
              "password": {
                "required": false
              },
              "id": {
                "required": false
              }
            },
            "valid_data": null
          }
        },
        "type": "user",
        "description": "Statseeker Users",
        "title": "User"
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496190907
  },
  "links": [
    {
      "link": "/api/v2.1/user/describe?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/user",
      "rel": "collection"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/discover/execute/?mode=single&ip=10.100.89.252&verbose=0&minimal=true&indent=3" 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "discover/execute/"

# specify fields to be returned and filters to use
getFields = "?mode=single&ip=10.100.89.252&verbose=0&minimal=true"

# optional response formatting
rspFormat = "&indent=3"

# set URL to be used
url = rootUri + targetUri + getFields + rspFormat


# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'discover/execute/'

# set feilds, filters etc
$fields = '?mode=single&ip=10.100.89.252&verbose=0&minimal=true'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
)

#output response to screen
    puts "#{response.to_str}"

{
	"info": "The Statseeker RESTful API",
	"data": {
		"objects": [{
			"status": {
				"errcode": 0,
				"success": true
			},
			"type": "discover"
		}],
		"errmsg": "ok",
		"success": true,
		"time": 1496191095
	},
	"links": [{
		"link": "/api/v2.1/discover/execute?mode=single&ip=10.100.89.252&verbose=0&minimal=true&indent=3",
		"rel": "self"
	}, {
		"link": "/api/v2.1",
		"rel": "base"
	}, {
		"link": "/api/v2.1/discover",
		"rel": "collection"
	}],
	"api_version": "2.1"
}
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/cdt_device/551/?fields=name,id,community,ipaddress,snmp_version&indent=3" 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_device/551"

# specify fields to be returned
getFields = "?fields=name,id,community,ipaddress,snmp_version"

# optional response formatting
rspFormat = "&indent=3"

# set URL to be used
url = rootUri + targetUri + getFields + rspFormat

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_device/551'

# set fields to return
$fields = '?fields=name,id,community,ipaddress,snmp_version'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "snmp_version": 2,
            "ipaddress": "10.116.4.172",
            "name": "Brisbane-Server1",
            "community": "public",
            "id": 551
          }
        ],
        "type": "cdt_device",
        "data_total": 1
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496191542
  },
  "links": [
    {
      "link": "/api/v2.1/cdt_device/551?fields=name,id,community,ipaddress,snmp_version&indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/cdt_device",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/auth_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/snmp_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_state",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysObjectID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/community",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/priv_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/table",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/id",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_rtt",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_outage",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_dup",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/hostname",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/memorySize",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/snmp_version",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysDescr",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_lost1",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysName",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_lost3",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_lost2",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ping_lost4",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/priv_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/ipaddress",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/auth_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysContact",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/idx",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysLocation",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/sysServices",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/snmpEngineID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/deviceid",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/context",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/auth_user",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/551/snmp_maxoid",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/42579/?indent=3" \
	-d '{"data":[{"name":"Bangalore1"}]}' 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "group/42579/"

# set data object
data = json.dumps({"data":[{"name":"Bangalore1"}]})

# optional response formatting
rspFormat = "?indent=3"

# set URL to be used
url = rootUri + targetUri + rspFormat

# send request 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'group/42579/'

# set payload in json format
$jData = '{"data":[{"name":"Bangalore1"}]}'

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	 :payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496192693
  },
  "links": [
    {
      "link": "/api/v2.1/group/42579?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/group/42579/entities",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/42579/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/42579/id",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X DELETE \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/42579/?indent=3"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "group/42579/"

# optional response formatting
rspFormat = "?indent=3"

# set URL to be used
url = rootUri + targetUri + rspFormat

# send request 
r = requests.delete(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'group/42579/'


# send request
response = RestClient::Request.execute(
	:method => :delete,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496192850
  },
  "links": [
    {
      "link": "/api/v2.1/group/42579?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/group/42579/entities",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/42579/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/42579/id",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/user/42572/tz/?indent=3"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "user/42572/tz/"

# optional response formatting
rspFormat = "?indent=3"

# set URL to be used
url = rootUri + targetUri + rspFormat

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'user/42572/tz/'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "tz": "Europe/London",
            "id": 42572
          }
        ],
        "type": "user",
        "data_total": 1
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496193742
  },
  "links": [
    {
      "link": "/api/v2.1/user/42572/tz?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/user/42572",
      "rel": "collection"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/user/42572/tz/?indent=3" \
	-d '{"value":"Europe/Paris"}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "user/42572/tz/"

# optional response formatting
rspFormat = "?indent=3"

# set URL to be used
url = rootUri + targetUri + rspFormat

# set data object
data = json.dumps({"value":"Europe/Paris"})

# send request 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '?indent=3'

# set target endpoint
$targetEndpoint = 'user/42572/tz/'

# set payload in json format
$jData = '{"value":"Europe/Paris"}'


# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri + $targetEndpoint + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496193864
  },
  "links": [
    {
      "link": "/api/v2.1/user/42572/tz?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/user/42572",
      "rel": "collection"
    }
  ],
  "api_version": "2.1"
}

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-X POST \
	-u user:pword "https://your.statseeker.server/api/v2.1/user/?indent=3" \
	-d '{"data":[{"name":"minerva","password":"transfiguration","auth":"File","email":"mmcgonagall@hogwarts.ac.uk","api":"r","tz":"Australia/Brisbane"}]}' 

#!/usr/bin/python 

# import urllib for handling the https connection
# import base54 for encoding the authentication details
# import json for parsing the response data
import urllib2, base64, json

# specify the api endpoint to be used
endpoint = "https://your.statseeker.server/api/v2.1/user"

# encode  credentials
user = "username"
pword = "statseekerpassword"
base64string = base64.encodestring('%s:%s' % (user, pword)).replace('\n', '')

# data
data = json.dumps({"data":[{"name":"minerva","password":"transfiguration","auth":"File","email":"mmcgonagall@hogwarts.ac.uk","api":"r","tz":"Australia/Brisbane"}]})

# build the request
request = urllib2.Request(endpoint, data)
request.add_header("Accept", "application/json")
request.add_header("Content-Type", "application/json")
request.add_header("Authorization", "Basic %s" % base64string)   


response = urllib2.urlopen(request)
data = json.load(response)
formatted_data = json.dumps(data, indent=3, sort_keys=True)

# use pygments to pretty-up the onscreen output, omit when writing to another output
from pygments import highlight, lexers, formatters
colorful_json = highlight(unicode(formatted_data, 'UTF-8'), lexers.JsonLexer(), formatters.TerminalFormatter())
print(colorful_json)

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'user/'

# define payload in json format
$jData = {
   :name => 'Minerva',
   :password => 'transfiguration',
   :auth => 'File',
   :email => 'mmcgonagall@hogwarts.ac.uk',
   :api => 'r',
   :tz => 'Australia/Brisbane'
 }
 
# set the json content as the value for the 'data' key
$jData = '{"data":[' + $jData.to_json + ']}'

# send request
response = RestClient::Request.execute(
	:method => :post,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "data":{
      "objects":[
         {
            "status":{
               "errcode":0,
               "success":true
            },
            "data":[
               {
                  "tz":"Australia/Brisbane",
                  "name":"Minerva",
                  "auth":"File",
                  "id":46460,
                  "api":"r",
                  "password":"transfiguration",
                  "email":"mmcgonagall@hogwarts.ac.uk"
               }
            ],
            "type":"user",
            "data_total":1
         }
      ],
      "errmsg":"ok",
      "success":true,
      "time":1496194842
   },
   "links":[
      {
         "link":"/api/v2.1/user?&indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/user/describe",
         "rel":"describedby"
      }
   ],
   "api_version":"2.1"
}

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/user/46460?indent=3" \
	-d '{"data":[{"api":"r","tz":"Europe/London"}]}' 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/user/46460"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# data
data = json.dumps({"data":[{"api":"rw","tz":"Europe/London"}]})

# send request
r = requests.put(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'


$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'user/46460'

# set payload in json format
$jData = {:tz => 'Europe/London'}
$jData = '{"data":[' + $jData.to_json + ']}'

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => {:content_type => :json},
	:user => $user,
	:password => $pword,
	:payload => $jData,
	) 
	
#output response to screen
puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "data":{
      "errmsg":"ok",
      "success":true,
      "time":1496195083
   },
   "links":[
      {
         "link":"/api/v2.1/user/46460?&indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/user",
         "rel":"collection"
      },
      {
         "link":"/api/v2.1/user/46460/tz",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/name",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/auth",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/email",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/api",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/password",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/user/46460/id",
         "rel":"item"
      }
   ],
   "api_version":"2.1"
}

curl \ 
	-H "Accept: application/json" \ 
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/cdt_device/425/?indent=3" \
	-d '{"data":[{"ping_poll":"on","snmp_poll":"off"}]}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/cdt_device/425"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# data, the key:value pair to be used to turn ping polling on and SNMP polling off
data = json.dumps({"data":[{"ping_poll":"on","snmp_poll":"off"}]}

# send request 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)

# display the response status code
print(r.status_code)

# display the contents of the response object
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'
 
$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_device/425'

# set payload in json format
$jData = {
	:'ping_poll' => "on",
	:'snmp_poll' => "off"
}

$jData = '{"data":[' + $jData.to_json + ']}'

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => {:content_type => :json},
	:user => $user,
	:password => $pword,
	:payload => $jData,
	) 
	
#output response to screen
puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496195512
  },
  "links": [
    {
      "link": "/api/v2.1/cdt_device/425?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/cdt_device",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/auth_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/snmp_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_state",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysObjectID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/community",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/priv_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/table",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/id",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_rtt",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_outage",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_dup",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/hostname",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/memorySize",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/snmp_version",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysDescr",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_lost1",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysName",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_lost3",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_lost2",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ping_lost4",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/priv_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/ipaddress",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/auth_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysContact",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/idx",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysLocation",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/sysServices",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/snmpEngineID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/deviceid",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/context",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/auth_user",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/425/snmp_maxoid",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/cdt_device/?fields=name,ipaddress,sysLocation,snmp_poll,ping_poll&snmp_poll_filter=IS(%27off%27)&ping_poll_filter=IS(%27on%27)" 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/cdt_device/?fields=name,ipaddress,sysLocation,snmp_poll,ping_poll&snmp_poll_filter=IS(\u0027off\u0027)&ping_poll_filter=IS(\u0027on\u0027)"

# credentials
user = "user"
pword = "pword"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3&links=none'

# set target endpoint
$targetEndpoint = 'cdt_device/'

#specify fields to return
$fields = '&fields=name,ipaddress,sysLocation,snmp_poll,ping_poll'

#specify filters to only return the details on the devices you want
$filters = '&snmp_poll_filter=IS(%27off%27)&ping_poll_filter=IS(%27on%27)'

response = RestClient::Request.new({
      method: :get,
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters,
      user: $user,
      password: $pword,
    }).execute
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "snmp_poll": "off",
            "name": "Athens-swt2",
            "ping_poll": "on",
            "sysLocation": "Athens",
            "ipaddress": "10.100.59.252",
            "id": 315
          },
          {
            "snmp_poll": "off",
            "name": "Adelaide-swt1",
            "ping_poll": "on",
            "sysLocation": "Adelaide",
            "ipaddress": "10.100.89.253",
            "id": 425
          }
        ],
        "type": "cdt_device",
        "data_total": 2
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496196534
  },
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/cdt_device/cdt_device/426?fields=name,ping_rtt&ping_rtt_formats=avg,vals&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m" 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json


# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/cdt_device/426?fields=name,ping_rtt&ping_rtt_formats=avg,vals&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m"

# credentials
user = "user"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_device/426'

# set fields to return
$fields = '?fields=name,ping_rtt'

# set formats for timeseries data
$tsFormats = '&ping_rtt_formats=avg,vals'

# set time-filter for timeseries data
$tsTimeFilter = '&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $tsFormats + $tsTimeFilter + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "ping_rtt": {
              "vals": [
                67,
                62,
                47,
                27,
                53,
                56,
                70,
                50,
                60,
                21,
                21,
                87,
                67,
                62,
                42
              ],
              "avg": 52.8
            },
            "id": 426,
            "name": "Adelaide-rtr"
          }
        ],
        "type": "cdt_device",
        "data_total": 1
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496203449
  },
  "links": [
    {
      "link": "/api/v2.1/cdt_device/426?fields=name,ping_rtt&ping_rtt_formats=avg,vals&ping_rtt_timefilter=range%3Dnow%20-%2015m%20TO%20now%20-1m",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/cdt_device",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/auth_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/snmp_poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_state",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysObjectID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/community",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/priv_pass",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/table",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/poll",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/id",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_rtt",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_outage",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_dup",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/hostname",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/memorySize",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/snmp_version",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysDescr",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_lost1",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysName",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_lost3",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_lost2",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ping_lost4",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/priv_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/ipaddress",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/auth_method",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysContact",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/idx",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysLocation",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/sysServices",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/snmpEngineID",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/deviceid",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/context",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/auth_user",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/cdt_device/426/snmp_maxoid",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X DELETE \
	-u user:pword "https://your.statseeker.server/api/v2.1/cdt_device/cdt_device/" 
	-d '{"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\"10.100.59.251\",\"10.100.59.252\")"}}}}'
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json


# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/cdt_device/"

# credentials
user = "user"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# data
data = json.dumps({"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\"10.100.59.251\",\"10.100.59.252\")"}}}})

# send request 
r = requests.delete(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability
$rspFormat = '?indent=3&links=none'

# set target endpoint
$targetEndpoint = 'cdt_device/'

# set payload in json format
$jData = '{"fields":{"ipaddress":{"field":"ipaddress","filter":{"query":"IN(\'10.100.59.251\',\'10.100.59.252\')"}}}}'


# send request
response = RestClient::Request.execute(
	:method => :delete,
	:url => $baseUri+$targetEndpoint,
	:headers => { 
		:content_type => :json
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "version":"2.1",
   "data":{
      "errmsg":"ok",
      "success":true,
      "time":1543786374
   },
   "links":[
      {
         "link":"/api/v2.1/cdt_device?indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/cdt_device/describe",
         "rel":"describedby"
      }
   ],
   "revision":"6"
}

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_device/?fields=id,name&name_filter=IS(%27NewYork-Floor53-Switch1%27)&indent=3"
	
	
curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/?fields=id,name,deviceid&name_filter=IS(%27Fa0/36%27)&deviceid_filter=IS(%27751%27)&indent=3"
	
	
curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X PUT \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/31619/?indent=3"
    -d '{"data":[{%27poll%27:%27off%27}]}'
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json


# Specify device and interface name
deviceName = "NewYork-Floor53-Switch1"
interfaceName = "Fa0/36"

# specify the api endpoint to be used and return the device ID
url = "https://your.statseeker.server/api/v2.1/cdt_device/?fields=id,name&name_filter=IS('" + deviceName + "')"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request to get deviceId
r = requests.get(url, headers=headers, auth=(user, pword))

# print request response code to screen
print("GET deviceId:" + str(r.status_code))

# decode the response and walk the object to the 'id' field
rdata = r.json()
p = rdata['data']['objects'][0]['data'][0]['id']

# print device ID to screen
print("deviceId: " + str(p))

# specify the api endpoint to be used, return the interface name, interface ID and device ID. Use the deviceID and interface name to filter the results down to just the interface we want.
url = "https://your.statseeker.server/api/v2.1/cdt_port/?fields=id,name,deviceid&name_filter=IS('" + interfaceName + "')&deviceid_filter=IS('" + str(p) + "')"

# send request to get interfaceId
r = requests.get(url, headers=headers, auth=(user, pword))

# print request response code to screen
print("GET interfaceId: " + str(r.status_code)) 

# decode the response and walk the object to the 'id' field
rdata = r.json()
p = rdata['data']['objects'][0]['data'][0]['id']

#print interface ID to screen
print("interfaceId: " + str(p))


# specify the api endpoint to be used and format output to remove links
noLinks = "/?links=none"
url = "https://your.statseeker.server/api/v2.1/cdt_port/" + str(p) + noLinks

# update poll status to turn off polling
data = json.dumps({"data":[{"poll":"off"}]})

# send request to update polling status
r = requests.put(url, headers=headers, auth=(user, pword), data=data)

# print request response code to screen
print("Update interface poll status: " + str(r.status_code))

# print response body to screen
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'


$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# specify the device name and interface name
$deviceName = "NewYork-Floor53-Switch1"
$interfaceName = "Fa0/36"


# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3&links=none'

# set target endpoint
$targetEndpoint = 'cdt_device/'

#specify fields to return
$fields = '&fields=id,name'

#specify filters to only return the details on the device you want
$filters = "&name_filter=IS('" + $deviceName + "')"

# send request to retrieve the device ID
response = RestClient::Request.new({
      method: :get,
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters,
      user: $user,
      password: $pword,
    }).execute

# print request response code to the screen
puts "#{'GET deviceid: ' + response.code.to_s}"

# parse the response contents and walk the object to the retrieve the device ID
$rdata = JSON.parse(response)
$p = $rdata['data']['objects'][0]['data'][0]['id']

# print the device ID to the screen
puts "#{'deviceID: ' + $p.to_s}"

# specify the endpoint, fields to retrieve and filters to apply to retrieve the interface ID
$targetEndpoint = 'cdt_port/'
$fields = $fields + ',deviceid'
$filters = "&name_filter=IS('" + $interfaceName + "')&deviceid_filter=IS('" + $p.to_s + "')"

# send request to retrieve the interface ID
response = RestClient::Request.new({
      method: :get,
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters,
      user: $user,
      password: $pword,
    }).execute

# print request response code to the screen
puts "#{'GET interfaceid: ' + response.code.to_s}"

# parse the response contents and walk the object to the retrieve the interface ID
$rdata = JSON.parse(response)
$p = $rdata['data']['objects'][0]['data'][0]['id']

# print interface ID to the screen
puts "#{'interfaceID: ' + $p.to_s}"

# specify the endpoint, and payload to update the interface poll status
$targetEndpoint = 'cdt_port/'+ $p.to_s + '/'
$jData = {:poll => 'off'}
$jData = '{"data":[' + $jData.to_json + ']}'

# send request to update the poll status
response = RestClient::Request.new({
      method: :put,
      headers: {
      	content_type: 'application/json'
      	},
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters,
      user: $user,
      password: $pword,
      payload: $jData,
    }).execute

#output response to screen
puts "#{response.to_str}"

#This response includes some logging (preceding the response data object) which is only relevant to the Python and Ruby implementations
GET deviceid: 200
deviceID: 751
GET interfaceid: 200
interfaceID: 31619
{
   "info":"The Statseeker RESTful API",
   "data":{
      "errmsg":"ok",
      "success":true,
      "time":1496196689
   },
   "api_version":"2.1"
}

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil&RxUtil_sort=1,desc,avg&deviceid_filter=IS(%22426%22)&RxUtil_formats=95th,avg,min&TxUtil_formats=95th,avg,min&RxTxDiscardsPercent_formats=total&RxTxDiscardsPercent_timefilter=range=start_of_today%20to%20now&RxUtil_timefilter=range=start_of_today%20to%20now&TxUtil_timefilter=range=start_of_today%20to%20now"
	
	
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json


# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_port/"

# specify fields to be returned and filters to use
getFields = "?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil"

# specify data formats for each metric
dataFormats = "&RxUtil_formats=95th,avg,min&TxUtil_formats=95th,avg,min&RxTxDiscardsPercent_formats=total"

#specify time filters, one for each timeseries metric being requested
timeFilters = "&RxTxDiscardsPercent_timefilter=range=start_of_today to now&RxUtil_timefilter=range=start_of_today to now&TxUtil_timefilter=range=start_of_today to now"

# specify data filters to select only those devices\interfaces you want to report on
dataFilters = "&deviceid_filter=IS('426')"

# optionally specify sorting of the response contents
sorting = "&RxUtil_sort=1,desc,avg"

# optional response formatting
rspFormat = "&indent=3&links=none"

# set URL to be used
url = rootUri + targetUri + getFields + dataFormats + timeFilters + dataFilters + sorting + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_port/'

# set fields to return
$fields = '?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil'

# set formats for timeseries data
$tsFormats = '&RxUtil_formats=95th,avg,min&TxUtil_formats=95th,avg,min&RxTxDiscardsPercent_formats=total'

# set time-filter for timeseries data
$tsTimeFilter = '&RxTxDiscardsPercent_timefilter=range=start_of_today to now&RxUtil_timefilter=range=start_of_today to now&TxUtil_timefilter=range=start_of_today to now'

# specify data filters to select only those devices\interfaces you want to report on
$dataFilters = "&deviceid_filter=IS('426')"

# optionally specify sorting of the response contents
$sorting = "&RxUtil_sort=1,desc,avg"

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $tsFormats + $tsTimeFilter + $dataFilters + $sorting + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{

    "info":"The Statseeker RESTful API",
    "version":"2.1",
    "data":{
        "objects":[
            {
                "status":{
                    "errcode":0,
                    "success":true
                },
                "data":[
                    {
                        "name":"Gi0/1",
                        "RxTxDiscardsPercent":{
                            "total":0
                        },
                        "deviceid":426,
                        "TxUtil":{
                            "avg":1.75023,
                            "95th":1.75023,
                            "min":1.75023
                        },
                        "RxUtil":{
                            "avg":24.8631,
                            "95th":38.1318,
                            "min":1.83953
                        },
                        "id":16747
                    },
                    {
                        "name":"Gi0/2",
                        "RxTxDiscardsPercent":{
                            "total":0.0126891
                        },
                        "deviceid":426,
                        "TxUtil":{
                            "avg":1.81332,
                            "95th":1.81332,
                            "min":1.81332
                        },
                        "RxUtil":{
                            "avg":22.1316,
                            "95th":38.7839,
                            "min":2.18792
                        },
                        "id":16748
                    },
                    {
                        "name":"Gi0/3",
                        "RxTxDiscardsPercent":{
                            "total":0
                        },
                        "deviceid":426,
                        "TxUtil":{
                            "avg":34.1365,
                            "95th":34.1365,
                            "min":34.1365
                        },
                        "RxUtil":{
                            "avg":15.8552,
                            "95th":38.6894,
                            "min":0.983334
                        },
                        "id":16746
                    }
                ],
                "type":"cdt_port",
                "data_total":3
            }
        ],
        "errmsg":"ok",
        "success":true,
        "time":1508455952
    },
    "links":[
        {
            "link":"/api/v2.1/cdt_port?fields=deviceid,id,name,RxTxDiscardsPercent,TxUtil,RxUtil&RxUtil_sort=1,desc,avg&deviceid_filter=IS(%22426%22)&RxUtil_formats=95th,avg,min&TxUtil_formats=95th,avg,min&RxTxDiscardsPercent_formats=total&RxTxDiscardsPercent_timefilter=range=start_of_today%20to%20now&RxUtil_timefilter=range=start_of_today%20to%20now&TxUtil_timefilter=range=start_of_today%20to%20now",
            "rel":"self"
        },
        {
            "link":"/api/v2.1",
            "rel":"base"
        },
        {
            "link":"/api/v2.1/cdt_port/describe",
            "rel":"describedby"
        },
        {
            "link":"/api/v2.1/cdt_port/16747",
            "rel":"item"
        },
        {
            "link":"/api/v2.1/cdt_port/16748",
            "rel":"item"
        },
        {
            "link":"/api/v2.1/cdt_port/16746",
            "rel":"item"
        }
    ],
    "revision":"2"

}

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/?fields=deviceid,id,name,RxUtil&RxUtil_formats=vals,avg&RxUtil_timefilter=range=now%20-%2030m%20to%20now%20-%201m&RxUtil_sort=1,desc,avg&limit=10&indent=3"
	
	
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_port/"

# specify fields to be returned and filters to use
getFields = "?fields=deviceid,id,name,RxUtil"

# specify data filters to select only those devices\interfaces you want to report on
# we want the top 10 across the network so no restrictions are applied
dataFilters = "" 

# set formats for timeseries data
dataFormats = "&RxUtil_formats=vals,avg"

#specify time filters, one for each timeseries metric being requested
timeFilters = "&RxUtil_timefilter=range=now - 30m to now - 1m"


# optionally specify sorting of the response contents
sorting = "&RxUtil_sort=1,desc,avg"

# use the 'limit' parameter to only return the 'top-10' interfaces
limit = "&limit=10"

# optional response formatting, useful when viewing the response data directly
rspFormat = "&indent=3"

# set URL to be used
url = rootUri + targetUri + getFields + dataFormats + timeFilters + dataFilters + sorting + limit + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_port/'

# set fields to return
$fields = '?fields=deviceid,id,name,RxUtil'

# set formats for timeseries data
$tsFormats = '&RxUtil_formats=vals,avg'

# set time-filter for timeseries data. 
# The range end-point of 'now - 1m' is used because the metrics have a 1minute polling interval
# and this ensures that the only 'null' value you see will be because the interface was unreachable
$tsTimeFilter = '&RxUtil_timefilter=range=now - 30m to now - 1m'

# specify data filters to select only those devices\interfaces you want to report on
$dataFilters = "" # we want the top 10 across the network so no restrictions are applied

# optionally specify sorting of the response contents
$sorting = "&RxUtil_sort=1,desc,avg"

# use the 'limit' parameter to only return the "top-10" interfaces
$limit = "&limit=10"

# Optional: the indent parameter is used to format the contents of the response object for readability when viewing it directly.
$rspFormat = '&indent=3'

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $tsFormats + $tsTimeFilter + $dataFilters + $sorting + $limit + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "data":{
      "objects":[
         {
            "status":{
               "errcode":0,
               "success":true
            },
            "data":[
               {
                  "id":29563,
                  "RxUtil":{
                     "vals":[
                        97.353318,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333355,
                        98.333321,
                        98.333321,
                        98.333355,
                        98.333321,
                        33.598908,
                        2.946662,
                        1.96666,
                        1.96666,
                        1.96666,
                        null
                     ],
                     "avg":83.326629
                  },
                  "deviceid":722,
                  "name":"Fa1/0/11"
               },
               {
                  "id":21079,
                  "RxUtil":{
                     "vals":[
                        null,
                        null,
                        null,
                        0.733321,
                        1.970551,
                        1.96666,
                        1.96806,
                        1.9655,
                        61.120341,
                        93.431091,
                        98.138897,
                        98.40343,
                        98.273485,
                        96.89914,
                        98.093909,
                        98.330044,
                        98.40343,
                        98.273485,
                        98.323081,
                        98.357487,
                        96.892518,
                        98.157705,
                        98.269184,
                        98.323115,
                        96.861116,
                        96.714923,
                        98.165009,
                        98.269184,
                        97.118549,
                        null,
                        null
                     ],
                     "avg":77.82397
                  },
                  "deviceid":650,
                  "name":"Gi5/0/2"
               },
               {
                  "id":26985,
                  "RxUtil":{
                     "vals":[
                        78.089353,
                        77.616128,
                        78.631117,
                        76.065075,
                        78.1383,
                        78.219947,
                        77.101124,
                        77.941316,
                        76.814711,
                        76.372002,
                        76.342886,
                        78.589201,
                        78.318353,
                        75.934788,
                        78.174515,
                        78.652928,
                        78.66665,
                        78.23616,
                        78.164378,
                        78.649856,
                        77.734059,
                        78.634496,
                        77.55322,
                        77.804271,
                        77.023812,
                        77.879228,
                        78.531652,
                        78.662895,
                        78.354569,
                        75.855428,
                        null
                     ],
                     "avg":77.758414
                  },
                  "deviceid":768,
                  "name":"Fa0/11"
               },
               {
                  "id":2153,
                  "RxUtil":{
                     "vals":[
                        77.879378,
                        78.645176,
                        78.472308,
                        78.324074,
                        77.934708,
                        78.003268,
                        76.706908,
                        78.441755,
                        78.457904,
                        77.495487,
                        77.438317,
                        78.463362,
                        78.642162,
                        76.651233,
                        75.663295,
                        77.003704,
                        78.612811,
                        78.666667,
                        77.964885,
                        78.089994,
                        76.432551,
                        76.621541,
                        77.322342,
                        77.968326,
                        78.639524,
                        76.891266,
                        78.605452,
                        78.159705,
                        76.332974,
                        75.956541,
                        null
                     ],
                     "avg":77.682921
                  },
                  "deviceid":193,
                  "name":"Gi2/9"
               },
               {
                  "id":30714,
                  "RxUtil":{
                     "vals":[
                        78.378837,
                        77.216051,
                        77.774848,
                        78.250837,
                        78.413653,
                        77.414912,
                        76.972305,
                        75.873314,
                        75.985954,
                        76.082449,
                        77.847927,
                        78.408704,
                        77.073271,
                        77.051699,
                        77.176969,
                        78.489361,
                        78.178372,
                        77.651217,
                        76.894208,
                        75.770231,
                        76.025481,
                        78.544623,
                        77.828301,
                        76.919979,
                        77.714398,
                        78.058291,
                        77.401463,
                        78.448674,
                        78.660608,
                        77.377809,
                        null
                     ],
                     "avg":77.462825
                  },
                  "deviceid":736,
                  "name":"Fa0/12"
               },
               {
                  "id":32488,
                  "RxUtil":{
                     "vals":[
                        78.666667,
                        77.681411,
                        78.649965,
                        77.918768,
                        77.835783,
                        78.136419,
                        78.657915,
                        78.666667,
                        77.556671,
                        77.698768,
                        78.65058,
                        77.047634,
                        78.183516,
                        76.413143,
                        77.231838,
                        78.616013,
                        78.666209,
                        77.76911,
                        77.184198,
                        78.366263,
                        78.661997,
                        78.281288,
                        76.563436,
                        76.747076,
                        77.343816,
                        76.841581,
                        78.149697,
                        74.802487,
                        73.349519,
                        71.561926,
                        null
                     ],
                     "avg":77.396679
                  },
                  "deviceid":504,
                  "name":"Gi1/0/16"
               },
               {
                  "id":1222,
                  "RxUtil":{
                     "vals":[
                        78.530976,
                        77.956594,
                        78.375567,
                        77.507376,
                        76.084442,
                        76.514266,
                        76.954808,
                        74.880109,
                        76.439272,
                        77.474041,
                        77.932247,
                        78.033316,
                        78.494515,
                        76.779599,
                        76.656719,
                        76.937441,
                        77.243375,
                        75.835696,
                        76.689077,
                        77.242153,
                        77.190902,
                        78.264644,
                        78.571008,
                        78.299546,
                        78.534513,
                        77.537133,
                        77.445396,
                        77.291124,
                        78.354357,
                        null,
                        null
                     ],
                     "avg":77.381042
                  },
                  "deviceid":181,
                  "name":"Gi6/14"
               },
               {
                  "id":2367,
                  "RxUtil":{
                     "vals":[
                        75.345319,
                        72.656756,
                        75.870433,
                        76.828785,
                        77.157243,
                        78.425364,
                        78.382909,
                        77.940521,
                        78.666667,
                        78.509274,
                        78.666667,
                        76.552834,
                        75.042799,
                        75.456802,
                        76.97282,
                        77.577503,
                        78.666667,
                        77.973961,
                        78.303082,
                        78.666667,
                        78.666667,
                        78.578442,
                        77.122372,
                        77.807718,
                        78.349674,
                        78.666667,
                        75.400096,
                        75.585894,
                        76.855112,
                        75.512914,
                        null
                     ],
                     "avg":77.206954
                  },
                  "deviceid":194,
                  "name":"Gi1/2"
               },
               {
                  "id":8584,
                  "RxUtil":{
                     "vals":[
                        77.97561,
                        77.722791,
                        78.344943,
                        78.613883,
                        78.664646,
                        78.666667,
                        78.666667,
                        77.602772,
                        78.556662,
                        78.216841,
                        78.377274,
                        77.442608,
                        78.457279,
                        77.771411,
                        77.199537,
                        77.481598,
                        78.188029,
                        78.633206,
                        78.02423,
                        77.377352,
                        78.175635,
                        76.745137,
                        73.567222,
                        74.380114,
                        75.384805,
                        75.878438,
                        77.238695,
                        76.509566,
                        73.208392,
                        70.963183,
                        null
                     ],
                     "avg":77.134506
                  },
                  "deviceid":348,
                  "name":"Gi2/5"
               },
               {
                  "id":1172,
                  "RxUtil":{
                     "vals":[
                        73.424889,
                        75.522717,
                        77.631222,
                        77.567205,
                        76.931232,
                        78.30398,
                        77.503891,
                        78.501185,
                        76.385164,
                        76.613239,
                        77.881423,
                        78.121247,
                        78.517736,
                        76.777161,
                        76.041178,
                        77.744862,
                        78.136419,
                        78.587361,
                        78.299412,
                        77.030403,
                        77.428207,
                        78.472315,
                        78.093322,
                        78.513009,
                        77.583797,
                        77.041094,
                        76.691593,
                        74.894807,
                        72.629668,
                        null,
                        null
                     ],
                     "avg":77.133439
                  },
                  "deviceid":181,
                  "name":"Gi4/20"
               }
            ],
            "type":"cdt_port",
            "data_total":36854
         }
      ],
      "errmsg":"ok",
      "success":true,
      "time":1496277485
   },
   "links":[
      {
         "link":"/api/v2.1/cdt_port?fields=deviceid,id,name,RxUtil&RxUtil_formats=vals,avg&RxUtil_timefilter=range=now%20-%2030m%20to%20now&RxUtil_sort=1,desc,avg&limit=10&indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/cdt_port/describe",
         "rel":"describedby"
      },
      {
         "link":"/api/v2.1/cdt_port/29563",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/21079",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/26985",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/2153",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/30714",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/32488",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/1222",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/2367",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/8584",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/1172",
         "rel":"item"
      },
      {
         "link":"/api/v2.1/cdt_port/?fields=deviceid,id,name,RxUtil&RxUtil_formats=vals,avg&RxUtil_timefilter=range=now%20-%2030m%20to%20now&RxUtil_sort=1,desc,avg&limit=10&indent=3&offset=10",
         "rel":"next"
      },
      {
         "link":"/api/v2.1/cdt_port/?fields=deviceid,id,name,RxUtil&RxUtil_formats=vals,avg&RxUtil_timefilter=range=now%20-%2030m%20to%20now&RxUtil_sort=1,desc,avg&limit=10&indent=3&offset=36850",
         "rel":"last"
      }
   ],
   "api_version":"2.1"
}

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/?fields=cdt_device.name,name,RxUtil,InOctets&timefilter=range=now%20-%201h%20to%20now&RxUtil_formats=avg,max&InOctets_formats=percentile&InOctets_stats={"percentile":90}&InOctets_sort=1,desc,percentile&limit=10&indent=3"	
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_port/"

# specify fields to be returned and filters to use
getFields = "?fields=cdt_device.name,name,RxUtil,InOctets"

# specify data formats for each metric
dataFormats = "&RxUtil_formats=avg,max&InOctets_formats=percentile"

#specify time filters
timeFilters = "&timefilter=range=now -1h to now"

# set Stats format for timeseries data
dataStats = "&InOctets_stats={%22percentile%22:90}"

# optionally specify sorting of the response contents
sorting = "&RxUtil_sort=1,desc,avg"

# optional response formatting
rspFormat = "&limit=10&indent=3&links=none"

# set URL to be used
url = rootUri + targetUri + getFields + dataFormats + timeFilters + dataStats + sorting + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '&indent=3'

# set target endpoint
$targetEndpoint = 'cdt_port/'

# set fields to return
$fields = '?fields=cdt_device.name,name,RxUtil,InOctets'

# set formats for timeseries data
$tsFormats = '&RxUtil_formats=avg,max&InOctets_formats=percentile'

# set stats for timeseries data
$tsStats = '&InOctets_stats={"percentile":90}'

# set time-filter for timeseries data
$tsTimeFilter = '&timefilter=range=now -1h to now'

# optionally specify sorting of the response contents
$sorting = "&InOctets_sort=1,desc,percentile"

# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $fields + $tsFormats + $tsTimeFilter + $tsStats + $sorting + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "version":"2.1",
   "data":{
      "objects":[
         {
            "status":{
               "errcode":0,
               "success":true
            },
            "data":[
               {
					"cdt_device.name": "NewYork-swt4",
					"name": "Gi5/15",
					"RxUtil": {
						"max": 98.2481,
						"avg": 48.017
					},
					"InOctets": {
						"percentile": 7341280000
					},
					"id": 1933
				},
				{
					"cdt_device.name": "Delhi-swt2",
					"name": "Gi2/13",
					"RxUtil": {
						"max": 98.2907,
						"avg": 44.0038
					},
					"InOctets": {
						"percentile": 7295740000
					},
					"id": 15052
				},
				{
					"cdt_device.name": "Tokyo-swt1",
					"name": "Gi2/19",
					"RxUtil": {
						"max": 98.2907,
						"avg": 32.8421
					},
					"InOctets": {
						"percentile": 7287930000
					},
					"id": 12776
				},
				{
					"cdt_device.name": "Chicago-swt4",
					"name": "Gi5/18",
					"RxUtil": {
						"max": 98.216,
						"avg": 34.635
					},
					"InOctets": {
						"percentile": 7285220000
					},
					"id": 26691
				},
				{
					"cdt_device.name": "Paris-swt2",
					"name": "Gi6/15",
					"RxUtil": {
						"max": 98.1732,
						"avg": 46.4893
					},
					"InOctets": {
						"percentile": 7281300000
					},
					"id": 7022
				},
				{
					"cdt_device.name": "Shanghai-swt2",
					"name": "Gi3/25",
					"RxUtil": {
						"max": 98.2907,
						"avg": 31.501
					},
					"InOctets": {
						"percentile": 7272460000
					},
					"id": 11885
				},
				{
					"cdt_device.name": "Lisbon-swt1",
					"name": "Gi6/13",
					"RxUtil": {
						"max": 97.8852,
						"avg": 37.6228
					},
					"InOctets": {
						"percentile": 7254440000
					},
					"id": 9684
				},
				{
					"cdt_device.name": "Paris-swt2",
					"name": "Gi4/7",
					"RxUtil": {
						"max": 97.9,
						"avg": 42.9049
					},
					"InOctets": {
						"percentile": 7252390000
					},
					"id": 7064
				},
				{
					"cdt_device.name": "NewYork-swt3",
					"name": "Gi7/9",
					"RxUtil": {
						"max": 97.8103,
						"avg": 30.7644
					},
					"InOctets": {
						"percentile": 7252000000
					},
					"id": 2039
				},
				{
					"cdt_device.name": "Budapest-swt3",
					"name": "Gi6/11",
					"RxUtil": {
						"max": 96.9925,
						"avg": 24.6683
					},
					"InOctets": {
						"percentile": 7251030000
					},
					"id": 7943
				}				
            ],
            "type":"cdt_port",
            "data_total":20640
         }
      ],
      "errmsg":"ok",
      "success":true,
      "time":1513223888
   },
   "links":[],
   "revision":"2"
}

curl \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -X GET \
    -u user:pword "https://your.statseeker.server/api/v2.1/cdt_port/3839/RxUtil?timefilter=range=%20now%20-%201h%20to%20now&formats=percentile&stats={"percentile":90}&links=none&indent=3"	
	

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "cdt_port/3839/RxUtil"

# specify data formats for each metric
dataFormats = "?formats=percentile"

#specify time filters, one for each timeseries metric being requested
timeFilters = "&timefilter=range=now -1h to now"

# set Stats format for timeseries data
dataStats = "&stats={%22percentile%22:90}"

# optional response formatting
rspFormat = "&indent=3&links=none"

# set URL to be used
url = rootUri + targetUri + dataFormats + timeFilters + dataStats + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request and 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

# api user credentials
$user = 'username'
$pword = 'password'

# api root endpoint
$baseUri = 'https://your.statseeker.server/api/v2.1/'


# this is simply used to format the contents of the response object for readability.
$rspFormat = '&indent=3&links=none'

# set target endpoint
$targetEndpoint = 'cdt_port/3839/RxUtil'

# set formats for timeseries data
$tsFormats = '?formats=percentile'

# set stats for timeseries data
$tsStats = '&stats={"percentile":90}'

# set time-filter for timeseries data
$tsTimeFilter = '&timefilter=range=now -1h to now'


# send request
response = RestClient::Request.execute(
	:method => :get,
	:url => $baseUri + $targetEndpoint + $tsFormats + $tsTimeFilter + $tsStats + $rspFormat, 
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "version":"2.1",
   "data":{
      "objects":[
         {
            "status":{
               "errcode":0,
               "success":true
            },
            "data":[
               {
                  "RxUtil":{
                     "percentile":76.8222
                  },
                  "id":3839
               }
            ],
            "type":"cdt_port",
            "data_total":1
         }
      ],
      "errmsg":"ok",
      "success":true,
      "time":1513229194
   },
   "revision":"2"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X POST \
	-u user:pword "https://your.statseeker.server/api/v2.1/group/?indent=3" \
	-d '{"data":[{"name":"Budapest"}]}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/group"

# credentials
user = "user"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# data, this is the name of group that will be created
data = json.dumps({"data":[{"name":"Budapest"}]})

# send request 
r = requests.post(url, headers=headers, auth=(user, pword), data=data)

# display the response status code
print(r.status_code)

# display the contents of the response object
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'group/'

# set payload in json format
$jData = {
   :name => 'Budapest',
 }
$jData = '{"data":[' + $jData.to_json + ']}'

# send request
response = RestClient::Request.execute(
	:method => :post,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "objects": [
      {
        "status": {
          "errcode": 0,
          "success": true
        },
        "data": [
          {
            "name": "Budapest",
            "id": 46461
          }
        ],
        "type": "group",
        "data_total": 1
      }
    ],
    "errmsg": "ok",
    "success": true,
    "time": 1496198383
  },
  "links": [
    {
      "link": "/api/v2.1/group?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group/describe",
      "rel": "describedby"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/46461/entities/?indent=3" \
	-d '{"value":[286,287,288,289,290,291,292,293],"mode":"add"}'

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
# we are going to entries to the entities list of the group
url = "https://your.statseeker.server/api/v2.1/group/46461/entities"

# credentials
user = "user"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# data specify the ID's of the devices to be added to the group, this adds the device plus all children (interfaces, in this case) 
# specify the mode, we are using "add" to add the devices without affecting any existing group members
data = json.dumps({"value":[286,287,288,289,290,291,292,293],"mode":"add"})

# send request 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)

# display the response status code
print(r.status_code)

# display the contents of the response object
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'group/46461/entities'

# set payload in json format
$jData = {
   :value => [286, 287, 288, 289, 290, 291, 292, 293],
   :mode => 'add',
 }
$jData = $jData.to_json

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword,
	:payload => $jData
)
#output response to screen
    puts "#{response.to_str}"

{
   "info":"The Statseeker RESTful API",
   "data":{
      "errmsg":"ok",
      "success":true,
      "time":1496200162
   },
   "links":[
      {
         "link":"/api/v2.1/group/46461/entities?&indent=3",
         "rel":"self"
      },
      {
         "link":"/api/v2.1",
         "rel":"base"
      },
      {
         "link":"/api/v2.1/group/46461",
         "rel":"collection"
      }
   ],
   "api_version":"2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X DELETE \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/group/46461/?indent=3" 

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/group/46461"

# credentials
user = "user"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# send request 
r = requests.delete(url, headers=headers, auth=(user, pword))


# display the response status code
print(r.status_code)

# display the contents of the response object
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# optional formatting of the response for onscreen readability
$rspFormat = '?&indent=3'

# set target endpoint, specifying the ID of the group to be deleted
$targetEndpoint = 'group/46461'


# send request
response = RestClient::Request.execute(
	:method => :delete,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => { 
		:content_type => :json,
  	},
	:user => $user,
	:password => $pword
)
#output response to screen
    puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496200297
  },
  "links": [
    {
      "link": "/api/v2.1/group/46461?indent=3",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/group",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/group/46461/entities",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/46461/name",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/group/46461/id",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X PUT \
	-u user:pword \
	"https://your.statseeker.server/api/v2.1/discover_config/1?indent=3" \
	-d "{"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]}"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# specify the api endpoint to be used
url = "https://your.statseeker.server/api/v2.1/discover_config/1"

# credentials
user = "username"
pword = "password"

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}


# data
data = json.dumps({"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]})

# send request 
r = requests.put(url, headers=headers, auth=(user, pword), data=data)
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'


$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is simply used to format the contents of the response object for readability.
$rspFormat = '?&indent=3'

# set target endpoint
$targetEndpoint = 'discover_config/1'

# set payload in json format
$jData = '{"data":[{"ranges":["include 10.100.0.0/16","exclude 10.100.[50-100].*","include 10.101.0.0/16","include 10.116.0.0/16"]}]}'

# send request
response = RestClient::Request.execute(
	:method => :put,
	:url => $baseUri+$targetEndpoint+$rspFormat,
	:headers => {:content_type => :json},
	:user => $user,
	:password => $pword,
	:payload => $jData,
	) 
	
#output response to screen
puts "#{response.to_str}"

{
  "info": "The Statseeker RESTful API",
  "data": {
    "errmsg": "ok",
    "success": true,
    "time": 1496200675
  },
  "links": [
    {
      "link": "/api/v2.1/discover_config/1",
      "rel": "self"
    },
    {
      "link": "/api/v2.1",
      "rel": "base"
    },
    {
      "link": "/api/v2.1/discover_config",
      "rel": "collection"
    },
    {
      "link": "/api/v2.1/discover_config/1/iftype",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/ranges",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/ping_rate",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/ping_count",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/communities",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/id",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/sysdescr",
      "rel": "item"
    },
    {
      "link": "/api/v2.1/discover_config/1/ping_skip",
      "rel": "item"
    }
  ],
  "api_version": "2.1"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/message/?indent=3&links=none&fields=entity,entityid,text,type,time&text_filter=LIKE(%22%25changed%20state%20to%20down%25%22)&time_timefilter=range%20=%20now%20-%201d%20to%20now"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "message/"

# specify fields to be returned and filters to use
getFields = "?fields=entity,entityid,text,type,time"

#specify filters for syslog events when the device went 'down'
filters = '&text_filter=LIKE("%25changed state to down%25")'

#specify time filter
timefilters = '&time_timefilter=range = now - 1d to now'

# optional response formatting
rspFormat = "&indent=3&links=none"

# set URL to be used
url = rootUri + targetUri + getFields + filters + timefilters + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request 
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'

# this is used to format the contents of the response object for readability
$rspFormat = '?indent=3&links=none'

# set target endpoint
$targetEndpoint = 'message/'

#specify fields to return
$fields = '&fields=entity,entityid,text,type,time'

#specify filters for syslog events when the device went 'down'
$filters = '&text_filter=LIKE("%25changed state to down%25")'

#specify time filter
$timefilters = '&time_timefilter=range = now - 1d to now'


response = RestClient::Request.new({
      method: :get,
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters + $timefilters,
      user: $user,
      password: $pword,
    }).execute

puts "#{response.to_str}"

{
	"info": "The Statseeker RESTful API",
	"data": {
		"objects": [{
			"status": {
				"errcode": 0,
				"success": true
			},
			"data": [{
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/10, changed state to down",
				"entity": "LosAngeles-swt1",
				"time": 1490240152,
				"entityid": 174,
				"type": "syslog",
				"id": 126619
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/7, changed state to down",
				"entity": "Helsinki-swt1",
				"time": 1490245557,
				"entityid": 313,
				"type": "syslog",
				"id": 126626
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet1/0/12, changed state to down",
				"entity": "CapeTown-swt2",
				"time": 1490246759,
				"entityid": 412,
				"type": "syslog",
				"id": 126628
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/18, changed state to down",
				"entity": "Mumbai-swt2",
				"time": 1490251556,
				"entityid": 379,
				"type": "syslog",
				"id": 126631
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/19, changed state to down",
				"entity": "Unknown (10.100.52.25)",
				"time": 1490270147,
				"entityid": 0,
				"type": "syslog",
				"id": 126641
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/24, changed state to down",
				"entity": "Budapest-swt4",
				"time": 1490271059,
				"entityid": 271,
				"type": "syslog",
				"id": 126642
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/18, changed state to down",
				"entity": "Phoenix-swt4",
				"time": 1490271643,
				"entityid": 201,
				"type": "syslog",
				"id": 126643
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/7, changed state to down",
				"entity": "Bangkok-swt1",
				"time": 1490279033,
				"entityid": 374,
				"type": "syslog",
				"id": 126647
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/20, changed state to down",
				"entity": "Unknown (10.100.52.25)",
				"time": 1490286824,
				"entityid": 0,
				"type": "syslog",
				"id": 126652
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet2/0/16, changed state to down",
				"entity": "Chicago-rtr",
				"time": 1490294444,
				"entityid": 185,
				"type": "syslog",
				"id": 126657
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/8, changed state to down",
				"entity": "Tokyo-swt1",
				"time": 1490301348,
				"entityid": 355,
				"type": "syslog",
				"id": 126661
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/8, changed state to down",
				"entity": "LosAngeles-rtr",
				"time": 1490305548,
				"entityid": 175,
				"type": "syslog",
				"id": 126664
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/18, changed state to down",
				"entity": "Helsinki-swt3",
				"time": 1490307644,
				"entityid": 311,
				"type": "syslog",
				"id": 126667
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet1/0/14, changed state to down",
				"entity": "Athens-rtr",
				"time": 1490316041,
				"entityid": 299,
				"type": "syslog",
				"id": 126671
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface FastEthernet0/28, changed state to down",
				"entity": "Melbourne-swt2",
				"time": 1490316942,
				"entityid": 397,
				"type": "syslog",
				"id": 126672
			}, {
				"text": "local0.info  %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/11, changed state to down",
				"entity": "Chicago-swt2",
				"time": 1490317855,
				"entityid": 183,
				"type": "syslog",
				"id": 126673
			}, {
				"text": "local0.info  %LINK-3-UPDOWN: Interface GigabitEthernet3/0/5, changed state to down",
				"entity": "Copenhagen-swt3",
				"time": 1490318756,
				"entityid": 331,
				"type": "syslog",
				"id": 126674
			}],
			"type": "message",
			"data_total": 17
		}],
		"errmsg": "ok",
		"success": true,
		"time": 1490325593
	},
	"api_version": "2.0"
}

curl \
	-H "Accept: application/json" \
	-H "Content-Type: application/json" \
	-X GET \
	-u user:pword "https://your.statseeker.server/api/v2.1/event_record/?indent=3&links=none&fields=event,eventid,device,deviceid,state,delta,time&state_filter=IS(%22up%22)&event_filter=IS(%22IF-MIB.ifOperStatus%22)&time_timefilter=range%20=%20now%20-%203h%20to%20now"

#!/usr/bin/python 

# import requests for handling connection and encoding
import requests, json

# credentials
user = "username"
pword = "password"

# API root endpoint
rootUri = "https://your.statseeker.server/api/v2.1/"

# specify target endpoint
targetUri = "event_record/"

# specify fields to be returned and filters to use
getFields = "?fields=event,eventid,device,deviceid,state,delta,time"

#specify filters
filters = '&state_filter=IS("up")&event_filter=IS("IF-MIB.ifOperStatus")'

#specify time filter
timefilters = '&time_timefilter=range = now - 3h to now'

# optional response formatting
rspFormat = "&indent=3&links=none"

# set URL to be used
url = rootUri + targetUri + getFields + filters + timefilters + rspFormat

# headers
headers = {"Accept":"application/json", "Content-Type":"application/json"}

# send request
r = requests.get(url, headers=headers, auth=(user, pword))
print(r.status_code)
print(r.json())

# install with: $ gem install rest-client
require 'rest_client'
require 'json'

$user = 'username'
$pword = 'password'
$baseUri = 'https://your.statseeker.server/api/v2.1/'


# this is used to format the contents of the response object for readability
$rspFormat = '?indent=3&links=none'

# set target endpoint
$targetEndpoint = 'event_record/'

#specify fields to return
$fields = '&fields=event,eventid,device,deviceid,state,delta,time'

#specify filters
$filters = '&state_filter=IS("up")&event_filter=IS("IF-MIB.ifOperStatus")'

#specify time filter
$timefilter = '&time_timefilter=range = now - 3h to now'

response = RestClient::Request.new({
      method: :get,
      url: $baseUri + $targetEndpoint + $rspFormat + $fields + $filters + $timefilter,
      user: $user,
      password: $pword,
    }).execute

puts "#{response.to_str}"

{
	"info": "The Statseeker RESTful API",
	"data": {
		"objects": [{
			"status": {
				"errcode": 0,
				"success": true
			},
			"data": [{
				"eventid": 17,
				"time": 1490328180,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 185,
				"delta": 23520,
				"device": "Chicago-rtr",
				"id": "58D49A74-1-1"
			}, {
				"eventid": 81,
				"time": 1490324821,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 284,
				"delta": 3960,
				"device": "Warsaw-rtr",
				"id": "58D48D55-1-1"
			}, {
				"eventid": 81,
				"time": 1490327161,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 284,
				"delta": 480,
				"device": "Warsaw-rtr",
				"id": "58D49679-1-1"
			}, {
				"eventid": 97,
				"time": 1490329921,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 293,
				"delta": 3540,
				"device": "Athens-srv1",
				"id": "58D4A141-1-1"
			}, {
				"eventid": 97,
				"time": 1490332501,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 293,
				"delta": 1080,
				"device": "Athens-srv1",
				"id": "58D4AB55-1-1"
			}, {
				"eventid": 129,
				"time": 1490326021,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 334,
				"delta": 4260,
				"device": "Copenhagen-rtr",
				"id": "58D49205-1-1"
			}, {
				"eventid": 145,
				"time": 1490324821,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 350,
				"delta": 6900,
				"device": "Shanghai-rtr",
				"id": "58D48D55-2-1"
			}, {
				"eventid": 145,
				"time": 1490328421,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 350,
				"delta": 2040,
				"device": "Shanghai-rtr",
				"id": "58D49B65-1-1"
			}, {
				"eventid": 177,
				"time": 1490329802,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 378,
				"delta": 19741,
				"device": "Delhi-rtr",
				"id": "58D4A0CA-1-1"
			}, {
				"eventid": 209,
				"time": 1490332022,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 840,
				"device": "Chennai-rtr",
				"id": "58D4A976-1-1"
			}, {
				"eventid": 209,
				"time": 1490332142,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 60,
				"device": "Chennai-rtr",
				"id": "58D4A9EE-1-1"
			}, {
				"eventid": 209,
				"time": 1490332502,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 390,
				"delta": 120,
				"device": "Chennai-rtr",
				"id": "58D4AB56-1-1"
			}, {
				"eventid": 225,
				"time": 1490325842,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 414,
				"delta": 840,
				"device": "CapeTown-rtr",
				"id": "58D49152-1-1"
			}, {
				"eventid": 225,
				"time": 1490328002,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 414,
				"delta": 1080,
				"device": "CapeTown-rtr",
				"id": "58D499C2-1-1"
			}, {
				"eventid": 241,
				"time": 1490323442,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 300,
				"device": "PortElizabeth-rtr",
				"id": "58D487F2-1-1"
			}, {
				"eventid": 241,
				"time": 1490327942,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 3900,
				"device": "PortElizabeth-rtr",
				"id": "58D49986-1-1"
			}, {
				"eventid": 241,
				"time": 1490329982,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 417,
				"delta": 1440,
				"device": "PortElizabeth-rtr",
				"id": "58D4A17E-1-1"
			}, {
				"eventid": 257,
				"time": 1490326322,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 6060,
				"device": "Pretoria-rtr",
				"id": "58D49332-1-1"
			}, {
				"eventid": 257,
				"time": 1490330462,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 2280,
				"device": "Pretoria-rtr",
				"id": "58D4A35E-2-1"
			}, {
				"eventid": 257,
				"time": 1490331122,
				"event": "IF-MIB.ifOperStatus",
				"state": "up",
				"deviceid": 423,
				"delta": 360,
				"device": "Pretoria-rtr",
				"id": "58D4A5F2-1-1"
			}],
			"type": "event_record",
			"data_total": 20
		}],
		"errmsg": "ok",
		"success": true,
		"time": 1490333357
	},
	"api_version": "2.0"
}