Default

patch

Change the connectivity state of a given IP:addr. With {acl : ban}: blacklist the given address and remove it from the whitelist if present. With {acl: open}: removes an address from the blacklist and whitelist. With {acl: trust}: trust a given address permanently and remove it from the blacklist if present. With {peer_id: <id>} set the peerId of the point. Connections from this address can still be closed on authentication if the peer is greylisted.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

pointstringRequired

A network point (ipv4:port or [ipv6]:port).

Body

application/json

aclstring · enumOptionalPossible values:

peer_idone ofOptional

stringOptional

or

Responses

200

Valid response

application/json

Information about a peer point. Includes flags, state, and records about past events.

trustedbooleanRequired

greylisted_untilone ofOptional

A timestamp as seen by the underlying, local computer: subsecond-level precision, epoch or rfc3339 based.

stringOptional

or

or

stringOptional

Decimal representation of 64 bit integers

stateone ofRequired

The state a connection to a peer point can be in: requested (connection open from here), accepted (handshake), running (connection already established), disconnected (no connection).

or

or

or

p2p_peer_idone ofOptional

stringOptional

or

last_failed_connectionone ofOptional

A timestamp as seen by the underlying, local computer: subsecond-level precision, epoch or rfc3339 based.

stringOptional

or

or

stringOptional

Decimal representation of 64 bit integers

last_missone ofOptional

A timestamp as seen by the underlying, local computer: subsecond-level precision, epoch or rfc3339 based.

stringOptional

or

or

stringOptional

Decimal representation of 64 bit integers

expected_peer_idone ofOptional

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

patch

/network/points/{point}

HTTPcURLJavaScriptPython

PATCH /network/points/{point} HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "acl": "open",
  "peer_id": "text"
}

{
  "trusted": true,
  "greylisted_until": "text",
  "state": {
    "event_kind": "requested"
  },
  "p2p_peer_id": "text",
  "last_failed_connection": "text",
  "last_rejected_connection": [
    "text"
  ],
  "last_established_connection": [
    "text"
  ],
  "last_disconnection": [
    "text"
  ],
  "last_seen": [
    "text"
  ],
  "last_miss": "text",
  "expected_peer_id": "text"
}