social.colibri.beta.server.listNodes

Lists the nodes of this AppView network that currently accept clients. Clients measure the round trip to each probe URL and connect their event socket, voice signaling and media requests to the fastest node.

Repository @colibri.social did:plc:mprdjqjluoswa7awzggaggj3 namespace authority
Details · query
Kindquery
Authorityserver.beta.colibri.social
Indexed

Query

query · GET

Output

application/json

nodes

requiredarray

Nodes that accept clients, in no particular order.

itemsref
Reference

#nodeView

object

A node that accepts clients.

Properties

endpoint

requiredstring · uri

Base URL of the node. Event sockets, voice signaling, blobs and embeds use it.

id

requiredstring

Stable node identifier.

probeUrl

requiredstring · uri

A cheap URL to measure the round trip to this node.

region

requiredstring

Region name, such as 'eu-north' or 'us-east'.

roles

requiredarray

What the node serves.

itemsstring
  • knownValues: main | failover | api | live | voice