···

       
11
       
11
       
 
       


     

       
12
       
12
       
 
       
- **status**: works! api is unstable and likely to change, and no known instances have a full network backfill yet.

     

       
13
       
13
       
 
       
- source: [./constellation/](./constellation/)

     

       
14
       
14
       
-
       
- public instance: [links.bsky.bad-example.com](https://links.bsky.bad-example.com/)

     

       
14
       
14
       
+
       
- public instance: [constellation.microcosm.blue](https://constellation.microcosm.blue/)

     

       
15
       
15
       
 
       


     

       
16
       
16
       
 
       
_note: the public instance currently runs on a little raspberry pi in my house, feel free to use it! it comes with only with best-effort uptime, no commitment to not breaking the api for now, and possible rate-limiting. if you want to be nice you can put your project name and bsky username (or email) in your user-agent header for api requests._

     

       
17
       
17
       
 
       


     

       
18
       
18
       
 
       


     

       
19
       
19
       
 
       
## API endpoints

     

       
20
       
20
       
 
       


     

       
21
       
21
       
-
       
currently this is a bit out of date -- refer to the [api docs hosted by the app itself](https://links.bsky.bad-example.com/) for now. they also let you try out live requests.

     

       
21
       
21
       
+
       
currently this is a bit out of date -- refer to the [api docs hosted by the app itself](https://constellation.microcosm.blue/) for now. they also let you try out live requests.

     

       
22
       
22
       
 
       


     

       
23
       
23
       
 
       
terms as used here:

     

       
24
       
24
       
 
       


     

···

       
183
       
183
       
 
       
    limit_req_zone $binary_remote_addr zone=cozy_ip_limit:10m rate=50r/s;

     

       
184
       
184
       
 
       
    limit_req_zone $server_name zone=cozy_global_limit:10m rate=1000r/s;

     

       
185
       
185
       
 
       


     

       
186
       
186
       
-
       
    # in sites-available/linsks.bsky.bad-example.com

     

       
186
       
186
       
+
       
    # in sites-available/constellation.microcosm.blue

     

       
187
       
187
       
 
       


     

       
188
       
188
       
 
       
    upstream cozy_link_aggregator {

     

       
189
       
189
       
 
       
      server link-aggregator:6789;

     
···

       
194
       
194
       
 
       
      listen 8080;

     

       
195
       
195
       
 
       
      listen [::]:8080;

     

       
196
       
196
       
 
       


     

       
197
       
197
       
-
       
      server_name links.bsky.bad-example.com;

     

       
197
       
197
       
+
       
      server_name constellation.microcosm.blue;

     

       
198
       
198
       
 
       


     

       
199
       
199
       
 
       
      proxy_cache cozy_zone;

     

       
200
       
200
       
 
       
      proxy_cache_background_update on;

     

···

       
18
       
18
       
 
       


     

       
19
       
19
       
 
       
- **status**: works! api is unstable and likely to change, and no known instances have a full network backfill yet.

     

       
20
       
20
       
 
       
- source: [./constellation/](./constellation/)

     

       
21
       
21
       
-
       
- public instance: [links.bsky.bad-example.com](https://links.bsky.bad-example.com/)

     

       
21
       
21
       
+
       
- public instance: [constellation.microcosm.blue](https://constellation.microcosm.blue/)

     

       
22
       
22
       
 
       


     

       
23
       
23
       
 
       
_note: the public instance currently runs on a little raspberry pi in my house, feel free to use it! it comes with only with best-effort uptime, no commitment to not breaking the api for now, and possible rate-limiting. if you want to be nice you can put your project name and bsky username (or email) in your user-agent header for api requests._

     

       
24
       
24