CSV Export and API instructions

Added descriptions for usage of the site to the about page, including
the first CSV export as well as instructions for using the API to search
for sites programtically.
symfony-version
Ro 2 years ago
parent 88e78f2c4a
commit 7c5ef7fb0e
Signed by: are0h
GPG Key ID: 29B551CDBD4D3B50

@ -68,6 +68,17 @@ a:hover {
border-bottom: 1px solid var(--secondary); border-bottom: 1px solid var(--secondary);
} }
pre {
white-space: pre;
background: var(--secondary);
}
code {
background: var(--secondary);
color: var(--primary);
padding: 3px;
}
sup { sup {
background: var(--black); background: var(--black);
color: var(--white); color: var(--white);

@ -1,4 +1,5 @@
{% extends "base/frame.twig" %} {% extends "base/frame.twig" %}
{% block stylesheets %} {% block stylesheets %}
<link rel="stylesheet" type="text/css" href="/assets/css/front/start.css?=sdfsdf"> <link rel="stylesheet" type="text/css" href="/assets/css/front/start.css?=sdfsdf">
{% endblock %} {% endblock %}
@ -9,6 +10,7 @@
<h2>What is The Bad Space?</h2> <h2>What is The Bad Space?</h2>
<p>The Bad Space project was born from a need to effectively identify instances that house bad actors and are poorly moderated, which puts marginalized communities at risk. <p>The Bad Space project was born from a need to effectively identify instances that house bad actors and are poorly moderated, which puts marginalized communities at risk.
</p>
<p> <p>
It is an extension of the It is an extension of the
<strong>#fediblock</strong> <strong>#fediblock</strong>
@ -18,11 +20,42 @@
<a href="https://digital.rooting.garden">Ginger</a> <a href="https://digital.rooting.garden">Ginger</a>
to provide a catalog of instances that seek to cause harm and reduce the quality of experience in the fediverse. to provide a catalog of instances that seek to cause harm and reduce the quality of experience in the fediverse.
</p> </p>
</p>
<p> <p>
Technical support provided by Technical support provided by
<a href="https://roiskinda.cool/profile.html">Ro</a>. <a href="https://roiskinda.cool/profile.html">Ro</a>.
</p> </p>
<h2>How do I use it?</h2>
<p>
The Bad Space is meant to be a resource for anyone looking to improve the quality of their online experience by creating a tool that catalogs sources for harassment and abuse. There are several options for how it can be used.
<h3>Search</h3>
To see if a site is listed in the database, use the
<a href="/">search feature</a>
to search for that URL. If it is in the database, information for that instance will be returned and associated instances if applicable.
<h3>CSV Exports</h3>
For a list of the current locations being tracked, click on one of the links below to download a dynamically generated CSV file that can be consumed as a blocklist. More formats will be added over time.
<br/>
<a href="/exports/mastodon">For Mastodon</a>
<h3>API</h3>
The Bad Space has a public api that can be used to search the database programatically and return results in the JSON format. The API can be accsess at<br/>
<code>https://thebad.space/api/v1/search</code>
by posting a JSON object with the following format:
<code>{"url":"search.url"}</code><br/>
Data from API request will be returned in the follow format:<br/>
<pre>
<code>{
"listingCount":1,
"locations":
[
{
"url":"search.url",
"name":"Instance Name",
"description":"instance description",
"link":"bad-space-instance-link"
}
]
}</code>
</pre>
</p>
</section> </section>
{% endblock %} {% endblock %}

Loading…
Cancel
Save