Introduction

Weimarnetz Registrator is a RESTful microservice for managing node number in our network. See https://wireless.subsignal.org/index.php?title=IP-System for more details.

Overview

HTTP verbs

Weimarnetz Registrator tries to adhere as closely as possible to standard HTTP and REST conventions in its use of HTTP verbs. To also support simple solutions like wget we wrap some verbs in GET requests.

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to update an existing resource, full updates only

DELETE

Used to delete an existing resource

HTTP status codes

Weimarnetz Registrator tries to adhere as closely as possible to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

Standard response for successful HTTP requests.

The actual response will depend on the request method used.

In a GET request, the response will contain an entity corresponding to the requested resource.

In a POST request, the response will contain an entity describing or containing the result of the action.

201 Created

The request has been fulfilled and resulted in a new resource being created.

303 See other

400 Bad Request

The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).

401 Unauthorized

404 Not Found

Resources

Time

Just returns the current server time.

Curl request

$ curl 'http://localhost:40153/time' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /time HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
host: localhost:40153
Accept: application/json

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:53 GMT
Content-Length: 27

{
  "now" : 1713621894007
}

Response body

{
  "now" : 1713621894007
}

Response fields

Path Type Description

now

Number

current time

Node

The Node resource is used to get a Node.

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten/2' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /ffweimar/knoten/2 HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
Accept: application/json
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:54 GMT
Content-Length: 235

{
  "message" : "ok",
  "status" : 200,
  "result" : {
    "key" : 44,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "ok",
  "status" : 200,
  "result" : {
    "key" : 44,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Nodes

The Nodes resource is used to get a list of Nodes.

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /ffweimar/knoten HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
Accept: application/json
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:54 GMT
Content-Length: 421

{
  "message" : "Ok",
  "status" : 200,
  "result" : [ {
    "key" : 40,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }, {
    "key" : 41,
    "number" : 3,
    "mac" : "03caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/3",
    "network" : "ffweimar"
  } ]
}

Response body

{
  "message" : "Ok",
  "status" : 200,
  "result" : [ {
    "key" : 40,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }, {
    "key" : 41,
    "number" : 3,
    "mac" : "03caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/3",
    "network" : "ffweimar"
  } ]
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result[0].key

long

Internal key

result[0].last_seen

long

Unix timestamp of last occurence

result[0].created_at

long

Unix timestamp of creation

result[0].location

class java.lang.String

Path of this resource

result[0].mac

class java.lang.String

Mac address of this node

result[0].network

class java.lang.String

Network name

result[0].number

int

Node numnber

Node by mac address

This resource is used to get a Node identified by a mac address.

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knotenByMac?mac=02:ca:ff:ee:ba:be' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /ffweimar/knotenByMac?mac=02:ca:ff:ee:ba:be HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
Accept: application/json
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:53 GMT
Content-Length: 235

{
  "message" : "ok",
  "status" : 200,
  "result" : {
    "key" : 13,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "ok",
  "status" : 200,
  "result" : {
    "key" : 13,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 456,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Add node

Adding a node returns the full node object

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten?mac=04caffeebabe&pass=test' -i -X POST \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'transfer-encoding: chunked' \
    -H 'Accept: application/json'

HTTP request

POST /ffweimar/knoten?mac=04caffeebabe&pass=test HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
transfer-encoding: chunked
Accept: application/json
Host: reg.weimarnetz.de
Content-Type: application/x-www-form-urlencoded

HTTP response

HTTP/1.1 201 Created
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Location: http://localhost:40153/ffweimar/knoten/4
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:54 GMT
Content-Length: 266

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 54,
    "number" : 4,
    "mac" : "04caffeebabe",
    "created_at" : 1713621894603,
    "last_seen" : 1713621894603,
    "location" : "/ffweimar/knoten/4",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 54,
    "number" : 4,
    "mac" : "04caffeebabe",
    "created_at" : 1713621894603,
    "last_seen" : 1713621894603,
    "location" : "/ffweimar/knoten/4",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Add node via GET

Adding a node returns the full node object

Curl request

$ curl 'http://reg.weimarnetz.de/POST/ffweimar/knoten?mac=04caffeebabe&pass=test' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /POST/ffweimar/knoten?mac=04caffeebabe&pass=test HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
Accept: application/json
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 201 Created
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Location: http://localhost:40153/ffweimar/knoten/4
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:54 GMT
Content-Length: 266

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 70,
    "number" : 4,
    "mac" : "04caffeebabe",
    "created_at" : 1713621894906,
    "last_seen" : 1713621894906,
    "location" : "/ffweimar/knoten/4",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 70,
    "number" : 4,
    "mac" : "04caffeebabe",
    "created_at" : 1713621894906,
    "last_seen" : 1713621894906,
    "location" : "/ffweimar/knoten/4",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Add node with given node number

Adding a node returns the full node object

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten/10?mac=05caffeebabe&pass=test' -i -X PUT \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'transfer-encoding: chunked' \
    -H 'Accept: application/json'

HTTP request

PUT /ffweimar/knoten/10?mac=05caffeebabe&pass=test HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
transfer-encoding: chunked
Accept: application/json
Host: reg.weimarnetz.de
Content-Type: application/x-www-form-urlencoded

HTTP response

HTTP/1.1 201 Created
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Location: http://localhost:40153/ffweimar/knoten/10
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:54 GMT
Content-Length: 268

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 62,
    "number" : 10,
    "mac" : "05caffeebabe",
    "created_at" : 1713621894818,
    "last_seen" : 1713621894818,
    "location" : "/ffweimar/knoten/10",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "Node created!",
  "status" : 201,
  "result" : {
    "key" : 62,
    "number" : 10,
    "mac" : "05caffeebabe",
    "created_at" : 1713621894818,
    "last_seen" : 1713621894818,
    "location" : "/ffweimar/knoten/10",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Update node

Updating a node returns the full node object

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten/2?mac=02caffeebabe&pass=test' -i -X PUT \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'transfer-encoding: chunked' \
    -H 'Accept: application/json'

HTTP request

PUT /ffweimar/knoten/2?mac=02caffeebabe&pass=test HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
transfer-encoding: chunked
Accept: application/json
Host: reg.weimarnetz.de
Content-Type: application/x-www-form-urlencoded

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:53 GMT
Content-Length: 250

{
  "message" : "updated",
  "status" : 200,
  "result" : {
    "key" : 17,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 1713621893971,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "updated",
  "status" : 200,
  "result" : {
    "key" : 17,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 1713621893971,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Update node via GET

Updating a node returns the full node object

Curl request

$ curl 'http://reg.weimarnetz.de/PUT/ffweimar/knoten/2?mac=02caffeebabe&pass=test' -i -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'Accept: application/json'

HTTP request

GET /PUT/ffweimar/knoten/2?mac=02caffeebabe&pass=test HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
Accept: application/json
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:53 GMT
Content-Length: 250

{
  "message" : "updated",
  "status" : 200,
  "result" : {
    "key" : 11,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 1713621893863,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response body

{
  "message" : "updated",
  "status" : 200,
  "result" : {
    "key" : 11,
    "number" : 2,
    "mac" : "02caffeebabe",
    "created_at" : 123,
    "last_seen" : 1713621893863,
    "location" : "/ffweimar/knoten/2",
    "network" : "ffweimar"
  }
}

Response fields

Path Type Description

status

int

HTTP Status code

message

class java.lang.String

Response message

result.key

long

Internal key

result.last_seen

long

Unix timestamp of last occurence

result.created_at

long

Unix timestamp of creation

result.location

class java.lang.String

Path of this resource

result.mac

class java.lang.String

Mac address of this node

result.network

class java.lang.String

Network name

result.number

int

Node numnber

Delete a node

Delete a node from the database, needs authentication

Curl request

$ curl 'http://reg.weimarnetz.de/ffweimar/knoten/4' -i -u 'adminuser:adminpass' -X DELETE \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'accept: */*'

HTTP request

DELETE /ffweimar/knoten/4 HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
accept: */*
Authorization: Basic YWRtaW51c2VyOmFkbWlucGFzcw==
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Date: Sat, 20 Apr 2024 14:04:54 GMT

Response body

Dump complete database

Dumps the complete database, needs authentication

Curl request

$ curl 'http://reg.weimarnetz.de/dumpDatabase' -i -u 'adminuser:adminpass' -X GET \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'accept: */*'

HTTP request

GET /dumpDatabase HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
accept: */*
Authorization: Basic YWRtaW51c2VyOmFkbWlucGFzcw==
Host: reg.weimarnetz.de

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Transfer-Encoding: chunked
Date: Sat, 20 Apr 2024 14:04:53 GMT
Content-Length: 518

[ {
  "key" : 8,
  "number" : 2,
  "mac" : "02caffeebabe",
  "created_at" : 123,
  "last_seen" : 456,
  "location" : "/ffweimar/knoten/2",
  "network" : "ffweimar"
}, {
  "key" : 9,
  "number" : 3,
  "mac" : "03caffeebabe",
  "created_at" : 123,
  "last_seen" : 456,
  "location" : "/ffweimar/knoten/3",
  "network" : "ffweimar"
}, {
  "key" : 10,
  "number" : 4,
  "mac" : "08caffeebabe",
  "created_at" : 1713621893536,
  "last_seen" : 1713621893536,
  "location" : "/ffweimar/knoten/4",
  "network" : "ffweimar"
} ]

Response fields

Path Type Description

[].key

long

Internal key

[].last_seen

long

Unix timestamp of last occurence

[].created_at

long

Unix timestamp of creation

[].location

class java.lang.String

Path of this resource

[].mac

class java.lang.String

Mac address of this node

[].network

class java.lang.String

Network name

[].number

int

Node numnber

Import database

Imports the complete database, needs authentication. Existing entries will be updated.

Curl request

$ curl 'http://reg.weimarnetz.de/importDatabase' -i -u 'adminuser:adminpass' -X POST \
    -H 'accept-encoding: gzip' \
    -H 'user-agent: ReactorNetty/1.1.18' \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d '[
  {
    "key": 12,
    "number": 22,
    "mac": "0202caffbabe",
    "created_at": 1618579261185,
    "last_seen": 1649942460672,
    "location": "/testnet/knoten/22",
    "network": "testnet"
  },
  {
    "key": 23,
    "number": 42,
    "mac": "02caffeebabe",
    "created_at": 1618579261185,
    "last_seen": 1649942460672,
    "location": "/testnet/knoten/42",
    "network": "testnet"
  },
  {
    "key": 42,
    "number": 23,
    "mac": "02c4ff33b4b3",
    "created_at": 1620320194435,
    "last_seen": 1620523256929,
    "location": "/ffweimar/knoten/23",
    "network": "ffweimar"
  }
]
'

HTTP request

POST /importDatabase HTTP/1.1
accept-encoding: gzip
user-agent: ReactorNetty/1.1.18
accept: */*
Content-Type: application/json
Authorization: Basic YWRtaW51c2VyOmFkbWlucGFzcw==
Content-Length: 596
Host: reg.weimarnetz.de

[
  {
    "key": 12,
    "number": 22,
    "mac": "0202caffbabe",
    "created_at": 1618579261185,
    "last_seen": 1649942460672,
    "location": "/testnet/knoten/22",
    "network": "testnet"
  },
  {
    "key": 23,
    "number": 42,
    "mac": "02caffeebabe",
    "created_at": 1618579261185,
    "last_seen": 1649942460672,
    "location": "/testnet/knoten/42",
    "network": "testnet"
  },
  {
    "key": 42,
    "number": 23,
    "mac": "02c4ff33b4b3",
    "created_at": 1620320194435,
    "last_seen": 1620523256929,
    "location": "/ffweimar/knoten/23",
    "network": "ffweimar"
  }
]

HTTP response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: SAMEORIGIN
Date: Sat, 20 Apr 2024 14:04:54 GMT

Request fields

Path Type Description

[].key

long

Internal key

[].last_seen

long

Unix timestamp of last occurence

[].created_at

long

Unix timestamp of creation

[].location

class java.lang.String

Path of this resource

[].mac

class java.lang.String

Mac address of this node

[].network

class java.lang.String

Network name

[].number

int

Node numnber