diff options
| author | Kristian Lyngstol <kly@kly@.no> | 2016-03-23 17:52:45 +0100 |
|---|---|---|
| committer | Kristian Lyngstol <kly@kly@.no> | 2016-03-23 17:52:45 +0100 |
| commit | e3349dd677fefd15c9678ce0f4bd0d651f9880ba (patch) | |
| tree | 725c163f753c4dc6fe2a8c16ecb10f9fea6f8552 | |
| parent | 904196acc73603ab48b7f4d5a8ba276f00d64222 (diff) | |
| parent | c96b6ff54b3d1df27b31803262688ca6b35ab003 (diff) | |
Merge branch 'master' of github.com:tech-server/tgmanage
| -rw-r--r-- | web/nms.gathering.org/api/API.rst | 86 |
1 files changed, 52 insertions, 34 deletions
diff --git a/web/nms.gathering.org/api/API.rst b/web/nms.gathering.org/api/API.rst index 61fbb5a..7d5c88b 100644 --- a/web/nms.gathering.org/api/API.rst +++ b/web/nms.gathering.org/api/API.rst @@ -19,6 +19,58 @@ Currently error handling sucks. This document is in no way complete, but it's a start. It will be updated as time permits and API's stabilize. +Public +...... + +Use URL https://nms-public.tg16.gathering.org/api/public + +/api/public/dhcp +---------------- + +Methods: GET +Update frequency: every second or so. + +Used to report time since last dhcp lease. + +/api/public/dhcp-summary +------------------------ + +Methods: GET +Update frequency: every second or so. + +Used to report dhcp lease stats. Both recent stats, and total stats. + +/api/public/ping +---------------- + +Methods: GET +Update frequency: every second or so. + +Used to report linknet latency. + +The switch latency is being integrated into switch-state.pl and linknet +latency will similarly be moved. + +/api/public/switches +-------------------- + +Methods: GET +Update frequency: Infrequent (on topology/config changes) + +List all switches and map positions. + +Used to draw switches on a map and provide static information. + +/api/public/switch-state +------------------------ + +Methods: GET +Update frequency: Every second + +Provides state for each switch, including total port speed, uplink port +speed, latency and temperature. + + Private ....... @@ -77,37 +129,3 @@ Accepts an array of switches. Magic: If you set placement to be "reset", it will re-calculate placement based on sysname. For new switches, this is redundant as an empty placement-field will trigger the same behavior. - - -Public -...... - -/api/public/ping ----------------- - -Methods: GET -Update frequency: every second or so. - -Used to report linknet latency. - -The switch latency is being integrated into switch-state.pl and linknet -latency will similarly be moved. - -/api/public/switches --------------------- - -Methods: GET -Update frequency: Infrequent (on topology/config changes) - -List all switches and map positions. - -Used to draw switches on a map and provide static information. - -/api/public/switch-state ------------------------- - -Methods: GET -Update frequency: Every second - -Provides state for each switch, including total port speed, uplink port -speed, latency and temperature. |