nonbinary.computer
atproto blogging
1{
2 "lexicon": 1,
3 "id": "com.atproto.sync.listHosts",
4 "defs": {
5 "host": {
6 "type": "object",
7 "required": [
8 "hostname"
9 ],
10 "properties": {
11 "accountCount": {
12 "type": "integer"
13 },
14 "hostname": {
15 "type": "string",
16 "description": "hostname of server; not a URL (no scheme)"
17 },
18 "seq": {
19 "type": "integer",
20 "description": "Recent repo stream event sequence number. May be delayed from actual stream processing (eg, persisted cursor not in-memory cursor)."
21 },
22 "status": {
23 "type": "ref",
24 "ref": "com.atproto.sync.defs#hostStatus"
25 }
26 }
27 },
28 "main": {
29 "type": "query",
30 "description": "Enumerates upstream hosts (eg, PDS or relay instances) that this service consumes from. Implemented by relays.",
31 "parameters": {
32 "type": "params",
33 "properties": {
34 "cursor": {
35 "type": "string"
36 },
37 "limit": {
38 "type": "integer",
39 "default": 200,
40 "minimum": 1,
41 "maximum": 1000
42 }
43 }
44 },
45 "output": {
46 "encoding": "application/json",
47 "schema": {
48 "type": "object",
49 "required": [
50 "hosts"
51 ],
52 "properties": {
53 "cursor": {
54 "type": "string"
55 },
56 "hosts": {
57 "type": "array",
58 "description": "Sort order is not formally specified. Recommended order is by time host was first seen by the server, with oldest first.",
59 "items": {
60 "type": "ref",
61 "ref": "#host"
62 }
63 }
64 }
65 }
66 }
67 }
68 }
69}