AutoPatrol, Bureaucrats, Administrators
481
edits
(Created page with "Web service API provides access to NetXMS via HTTP/HTTPS. API calls are REST-like (although not purely RESTful) and uses JSON for data exchange. = Session Management = == Lo...") |
m (Text replacement - "^" to "{{deprecated}}") |
||
(11 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
Web service API provides access to NetXMS via HTTP/HTTPS. API calls are REST-like (although not purely RESTful) and uses JSON for data exchange. | {{deprecated}}Web service API provides access to NetXMS via HTTP/HTTPS. API calls are REST-like (although not purely RESTful) and uses JSON for data exchange. | ||
= Session Management = | = Session Management = | ||
Line 22: | Line 22: | ||
== Get Objects == | == Get Objects == | ||
'''GET''' /objects | '''GET''' /objects | ||
'''GET''' /objects?''filter'' | '''GET''' /objects?''filter'' | ||
Get all objects visible to logged in user. Optional filter can define additional criteria for object selection: | Get all objects visible to logged in user. Optional filter can define additional criteria for object selection: | ||
area=''geographical_area'' | |||
class=''class_list'' | |||
name=''pattern'' | name=''pattern'' | ||
class='' | '''Examples''' | ||
Get all objects with name starting with "T": | |||
GET /objects?name=T* | |||
Get all nodes around Riga: | |||
GET /objects?class=node&area=57.0592,23.1647,56.8270,24.6025 | |||
Get all nodes and containers: | |||
GET /objects?class=container,node | |||
Get DCI Summary adHoc | |||
POST /summaryTable/adHoc | |||
Post payload: | |||
<pre> | |||
{ | |||
"baseObject":"ContainerName", | |||
"multiInstance":false, | |||
"columns": [ | |||
{ | |||
"columnName":"Free form name that will be used in return table for this column", | |||
"dciName":"Name of DCI, that will be used for filtering" | |||
}, | |||
{ | |||
"columnName":"Name2", | |||
"dciName":"DCIName2" | |||
} | |||
] | |||
}</pre> | |||
== Get Specific Object == | |||
'''GET''' /objects/''id'' | |||
== Get Last Values for Object == | |||
'''GET''' objects/''id''/lastvalues | |||
== CURL Test == | |||
Test API with Curl | |||
<pre> | |||
$ curl -X POST --data '{"login":"user","password":"pass"}' "http://localhost:8080/netxms-websvc/sessions" | |||
{ | |||
"sessionHandle": "8338e7f3-ba99-46c5-9fd6-84b38cc5d715", | |||
"session": { | |||
"server": { | |||
"address": "127.0.0.1", | |||
"version": "2.2.8", | |||
"color": "", | |||
"id": 3283229296059149299, | |||
"timeZone": "CET+02CEST" | |||
}, | |||
"user": { | |||
"name": "user", | |||
"id": 8, | |||
"globalAccessRights": 825439032336 | |||
}, | |||
"encrypted": false, | |||
"objectsSynchronized": false, | |||
"passwordExpired": false, | |||
"zoningEnabled": false | |||
} | |||
} | |||
$ curl -X GET --cookie "session_handle=8338e7f3-ba99-46c5-9fd6-84b38cc5d715" "http://localhost:8080/netxms-websvc/objects?class=container,node" | |||
.. prints some data .. | |||
</pre> | |||
= Java 10 = | |||
If curl test works but grafana returns "Internal error" ({"description":"Internal error","error":46}")<br> | |||
Add "--add-modules java.xml.bind" to JAVA_OPTS in /etc/default/tomcat8 |