Open Ports Monitoring API (v0.0.1)
Enabling and disabling open port monitoring for an IP address, viewing a list of open ports on an IP address, and tagging trusted open ports
Connect the IP address to the Monitoring service
Authorizations:
X-Token
Request Body schema: application/json
IP address that you want to connect to the service
ip required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 201
- 400
- 403
- 409
- 500
Content type
application/json
{- "response": {
- "code": 201,
- "text": "Created"
}, - "result": {
- "message": "Successful addition of the IP address",
- "addedIP": {
- "ip": "10.10.10.10",
- "client_id": 123456,
- "modified": "2023-06-15T10:10:09.101586Z"
}
}
}
Disconnect the IP address from the Monitoring service
Authorizations:
X-Token
Request Body schema: application/json
IP address to be disconnected from the service
ip required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
{- "response": {
- "code": 200,
- "text": "OK"
}, - "result": "Successful deletion of the IP address"
}
Get a list of open ports of all IPs or a specific IP
Authorizations:
X-Token
Request Body schema: application/json
(Optional) The IP address for which to get a list of open ports
ip | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
{- "response": {
- "code": 200,
- "text": "OK"
}, - "result": {
- "message": "Open ports were found",
- "ports": [
- {
- "ip": "10.10.10.10",
- "port": 22,
- "created": "2023-06-15T10:10:09.101586Z",
- "known": true
}
]
}
}
Set the "trusted" tag for open ports of a specific IP or all IPs connected to the service
Authorizations:
X-Token
Request Body schema: application/json
(Optional) IP address whose open ports you want to set as "trusted"
ip | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
{- "response": {
- "code": 200,
- "text": "OK"
}, - "result": "Successful tag change for 1 ports"
}
Get the status of a specific port for the selected IP
Authorizations:
X-Token
path Parameters
port required | string Example: 22 Open port number |
Request Body schema: application/json
IP address
ip required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
{- "response": {
- "code": 200,
- "text": "OK"
}, - "result": {
- "message": "Open ports were found",
- "ports": [
- {
- "ip": "10.10.10.10",
- "port": 22,
- "created": "2023-06-15T10:10:09.101586Z",
- "known": true
}
]
}
}
Change the KNOWN tag for the open port of the selected IP
Authorizations:
X-Token
path Parameters
port required | string Example: 22 Open port number |
Request Body schema: application/json
IP address
ip required | string |
Responses
Request samples
- Payload
Content type
application/json
{- "ip": "192.168.100.2"
}
Response samples
- 200
- 400
- 403
- 404
- 500
Content type
application/json
{- "response": {
- "code": 200,
- "text": "OK"
}, - "result": "Successful tag change for 1 ports"
}