Tor relay list in JSON

src/controllers/home.controller.ts

@@ -36,4 +36,11 @@ router.get("/docs/dns-hsts-preloading/", (req: Request, res: Response, next: Nex
   });
 });
 
+router.get("/docs/tor-relay-list/", (req: Request, res: Response, next: NextFunction) => {
+  res.render("docs/tor-relay-list.twig", {
+    "canonical_url": "/docs/tor-relay-list/",
+    "title": "Tor relay list in JSON",
+  });
+});
+
 export const HomeController: Router = router;

views/docs/index.twig

@@ -76,6 +76,12 @@ location: https://peeringdb.com/api/net/291</code></pre>
     <li><a href="/docs/dns-hsts-preloading/">DNS list for HSTS preloaded domains</a></li>
   </ul>
 
+  <h2>JSON lists</h2>
+
+  <ul>
+    <li><a href="/docs/tor-relay-list/">Tor relay list in JSON</a></li>
+  </ul>
+
   <h2>DNS-over-HTTPS</h2>
 
   <ul>

views/docs/tor-relay-list.twig

+{% extends 'layouts/default.twig' %}
+
+{% block body %}
+  <h1>{{ title }}</h1>
+
+  <p>The data originates from <a href="https://www.dan.me.uk/tornodes">Tor Node List</a> on dan.me.uk.</p>
+
+  <p><a href="https://gitlab.lelux.fi/TelcoDB/tor-relay-list">The source code is available on GitLab</a>.</p>
+
+  <p class="mb-1">The data is currently powering the following pages:
+    <ul class="mb-0">
+      <li><a href="/tor-relay/">GUI for exploring Tor relays</a></li>
+    </ul></p>
+
+  <h2>Downloads</h2>
+
+  <ul>
+    <li><a href="https://api.telcodb.net/dl/tor-relay-list.txt">TXT format</a>
+      (unmodified, cut from <a href="https://www.dan.me.uk/tornodes">original</a>)</li>
+    <li><a href="https://api.telcodb.net/dl/tor-relay-list.json">JSON format</a></li>
+  </ul>
+
+  <p class="mb-2">The JSON version currently has the following extra features that are not available on the origin:
+    <ul>
+      <li><a href="https://en.wikipedia.org/wiki/Reverse_DNS_lookup">Reverse DNS</a> records</li>
+    </ul></p>
+
+  <p>The data is automatically updated to the forementioned endpoints,
+    see the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Last-Modified"
+      class="text-code text-monospace">Last-Modified</a> header on the response.</p>
+
+  <hr>
+  <p><a href="/docs/">Go back to documentation</a></p>
+{% endblock %}
\ No newline at end of file

views/home/about.twig

@@ -24,7 +24,9 @@
 
   <h3>Tor Relay data</h3>
   <ul>
-    <li><a href="https://www.dan.me.uk/dnsbl">Tor Relay List by dan.me.uk</a></li>
+    <li><a href="https://www.dan.me.uk/dnsbl">Tor Relay DNSBL by dan.me.uk</a></li>
+    <li><a href="/docs/tor-relay-list/">Tor Relay List in JSON format</a>
+      (based on <a href="https://www.dan.me.uk/tornodes">dan.me.uk</a>'s data)</li>
   </ul>
   
   </p>

views/tor-relay/list.twig

@@ -3,7 +3,6 @@
 {% block body %}
   <h1>{{ title }}</h1>
 
-
   <table class="table" id="torRelayList">
     <thead>
       <tr>
@@ -35,6 +34,8 @@
       {% endfor %}
     </tbody>
   </table>
+
+  <p>The data is also available in <a href="/docs/tor-relay-list/">JSON &amp; TXT formats</a>.</p>
 {% endblock %}
 
 {% block javascripts %}