Constellation, Spacedust, Slingshot, UFOs: atproto crates and services for microcosm
document the count endpoint
+28
+28
link_aggregator/readme.md
+28
link_aggregator/readme.md
···
1
1
# link_aggregator
2
2
3
+
## endpoints
4
+
5
+
terms as used here:
6
+
7
+
- "URI": a URI, AT-URI, or DID.
8
+
- "JSON path": a dot-separated (and dot-prefixed, for now) path to a field in an atproto record. Arrays are noted by `[]` and cannot contain a specific index.
9
+
10
+
### `GET /links/count`
11
+
12
+
The number of backlinks to a URI from a specified collection + json path.
13
+
14
+
Required URL parameters
15
+
16
+
- `target` (required): the URI. must be URL-encoded.
17
+
- example: `at%3A%2F%2Fdid%3Aplc%3A57vlzz2egy6eqr4nksacmbht%2Fapp.bsky.feed.post%2F3lg2pgq3gq22b`
18
+
- `collection` (required): the source NSID of referring documents to consider.
19
+
- example: `app.bsky.feed.post`
20
+
- `path` (required): the JSON path in referring documents to consider.
21
+
- example: `.subject.uri`
22
+
23
+
cURL Example: Get a count of all bluesky likes for a post
24
+
25
+
```bash
26
+
curl 'http://raspberrypi.local:6789/links/count?target=at%3A%2F%2Fdid%3Aplc%3A57vlzz2egy6eqr4nksacmbht%2Fapp.bsky.feed.post%2F3lg2pgq3gq22b&collection=app.bsky.feed.like&path=.subject.uri'
27
+
28
+
40
29
+
```
30
+
3
31
4
32
some todos
5
33