forked from Erkan-Yilmaz/ToS-DR
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathapi.html
208 lines (179 loc) · 12.2 KB
/
api.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>API - Terms of Service; Didn't Read</title>
<meta name="description" content="Terms of Service; Didn't Read (ToS;DR) is an active project to fix the biggest lie on the web. We help you understand the Terms and Conditions and Privacy Policies of websites.">
<meta name="author" content="Terms of Service; Didn't Read">
<!--[if lt IE 9]><script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
<link href="css/bootstrap.css" rel="stylesheet">
<link href="css/bootstrap-responsive.css" rel="stylesheet">
<link href="css/custom.css" rel="stylesheet">
<link rel="shortcut icon" href="img/tosdr-icon-16.png">
<link rel="apple-touch-icon-precomposed" sizes="144x144" href="img/tosdr-icon-144.png">
<link rel="apple-touch-icon-precomposed" sizes="114x114" href="img/tosdr-icon-114.png">
<link rel="apple-touch-icon-precomposed" sizes="72x72" href="img/tosdr-icon-72.png">
<link rel="apple-touch-icon-precomposed" href="img/tosdr-icon-57.png">
<script src="js/jquery-1.7.1.min.js"></script>
<meta name="viewport" content="width=device-width; initial-scale=1.0; maximum-scale=1.0;"> <!--http://j.mp/mobileviewport-->
</head>
<body id="api-html" data-spy="scroll">
<div class="navbar navbar-fixed-top" id="menu-options">
<div class="navbar-inner">
<div class="container">
<button type="button"class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="brand" href="index.html"><img src="img/tosdr-icon-16.png" alt="" style="vertical-align:baseline;margin-right:.5em;" class="logo" />Terms of Service; Didn't Read</a>
<div class="nav-collapse collapse">
<ul class="nav">
<li class=""><a href="intex.html#services">Ratings</a></li>
<!-- <li class=""><a href="#classification">Classification</a></li>-->
<!-- <li class=""><a href="#workinprogress">Progress</a></li>-->
<li class=""><a href="about.html">About</a></li>
<!-- <li class=""><a href="#categories">Categories</a></li>-->
</ul>
<!-- <p class="pull-right">-->
<!-- <a href="#funding" class="btn btn-success btn-mini" style="position:absolute;">Donate</a>-->
<!-- </p>-->
<p class="pull-right follow-us">
Follow us <a href="http://twitter.com/tosdr">@tosdr</a>
Donate: <a href="http://flattr.com/thing/821090/ToSDR" target="_blank"><img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" border="0" /></a>
</p>
</div>
</div>
</div>
</div>
<div class="hero-unit" id="api">
<div class="container">
<div class="page-header"><h1>API</h1></div>
<p>
We encourage people to develop applications and other services integrating our ratings into their work. This page should help you use our data for your own app. Our source code is <a href="http://github.com/didnotread/didnotread.org">on github</a>.
</p>
<p>Suggestions: <a href="https://github.com/didnotread/didnotread.org/issues/11">browser extensions</a></p>
</div>
</div>
<div class="container" id="tosdr-content" role="main">
<h2 class="page-header">All data in machine-readable JSON</h2>
<ul>
<li>Each service (e.g. facebook) has a JSON file, see all at <a href="https://github.com/didnotread/didnotread.org/tree/master/services/">http://tos-dr.info/services/</a></li>
<li>Each point (e.g. "facebook tracks you") has a JSON file, see all at <a href="https://github.com/didnotread/didnotread.org/tree/master/points/">http://tos-dr.info/points/</a></li>
<li>Each topic (e.g. "scope of copyright license") has a JSON file, see all at <a href="https://github.com/didnotread/didnotread.org/tree/master/topics/">http://tos-dr.info/topics/</a></li>
<li>We also have an Index, see <a href="https://github.com/didnotread/didnotread.org/tree/master/index">http://tos-dr.info/index/</a> generated by <code>node <a href="https://github.com/didnotread/didnotread.org/blob/master/buildIndexes.js">buildIndexes.js</a></code></li>
</ul>
<h3 class="page-header">Use</h3>
<p>
Our (un)hoster 5apps has <a href="http://www.w3.org/wiki/CORS_Enabled">enabled CORS</a>. Example with jQuery to get Facebook</a>:
</p>
<pre>
$.getJSON("http://tos-dr.info/services/facebook.json").done(function(data) {
return console.log(JSON.stringify(data));
});</pre>
<p id="licensing">All JSON files are published under the <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">CC BY-SA 3.0</a> license with a special exception to allow distribution in a "larger program" under the GNU <a href="http://www.gnu.org/licenses/agpl-3.0-standalone.html" rel="license">AGPL-3.0</a>.</p>
<h2>Service format</h2>
<p>Example from facebook: <a href="https://github.com/didnotread/didnotread.org/blob/master/services/facebook.json">http://tos-dr.info/services/facebook.json</a></p>
<pre>
{
"id": "facebook",
"type":"service",
"name": "Facebook",
"url": "facebook.com",
"tosback2": {
"sitename": "facebook.com",
"privacy": {
"name": "Data Use Policy",
"url": "http://www.facebook.com/full_data_use_policy"
},
"terms": {
"name": "Terms of Service",
"url": "http://www.facebook.com/legal/terms"
}
},
"tosdr": {"rated": false},
"related": ["diaspora"],
"keywords": "social network"
}</pre>
<p>The rating Class attributed by ToS;DR is inside <code>tosdr.rated</code> and can be either "false" or "A", "B", "C", "D", or "E".</p>
<p>Ideally, the data inside "tosback2" should be pulled from tosback2 "rules" files: <a href="https://github.com/pde/tosback2/tree/master/rules/">https://github.com/pde/tosback2/tree/master/rules/</a>. We want to integrate with them for this (and other tracking/archiving projects!)</p>
<p>To get all data points concerning Facebook, you need to pull data points' id associated with "facebook" from <a href="https://github.com/didnotread/didnotread.org/blob/master/index/services.json">index/services.json</a> (for cache reasons, it may be <a href="https://github.com/didnotread/didnotread.org/blob/master/index/services.json">index/services.json</a> temporarily)</p>
<h2 id="data-point">Data point format</h2>
<p>Example from Github's "Your account can be suspended and your data deleted any time for any reason" <a href="https://github.com/didnotread/didnotread.org/blob/master/points/hI5Too_uDVk.json">http://tos-dr.info/points/hI5Too_uDVk.json</a></p>
<pre>
{
"id": "hI5Too_uDVk",
"name": "Your account can be suspended and your data deleted any time for any reason",
"service": "github",
"tosdr": {
"topic": "suspension",
"point": "mediocre",
"score": 30,
"tldr": "“GitHub, in its sole discretion, has the right to suspend or terminate your account and refuse any and all current or future use of the Service, or any other GitHub service, for any reason at any time. Such termination of the Service will result in the deactivation or deletion of your Account or your access to your Account, and the forfeiture and relinquishment of all Content in your Account. GitHub reserves the right to refuse service to anyone for any reason at any time. ” However, most of your data at GitHub can be exported with 'git clone' (for the wiki) and with the API (for the issues)."
},
"discussion": "https://groups.google.com/d/topic/tosdr/hI5Too_uDVk/discussion",
"source": {
"privacy": "https://github.com/site/terms"
},
"meta": {
"license-for-this-file":"This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, .USA",
"author": "ToS;DR by Unhosted",
"contributors": [ "Hugo Roy <[email protected]>" ]
}
}</pre>
<p>The list of topics can be found in <a href="https://github.com/didnotread/didnotread.org/tree/master/topics/">http://tos-dr.info/topics/</a>. A <code>tosdr.point</code> can be either "good", "not bad" (means "informative" or "neutral"), "mediocre", or "alert".</p>
<h2 class="page-header">Examples</h2>
<p>
ToS Checker is <a href="https://github.com/shybyte/tos-checker">an extension for Chrome/Chromium</a>, by shybyte.
</p>
<p>
It would be great if you could give us feedback on this very simple API page on github or by email. Thanks!
</p>
</div> <!-- /container -->
<footer id="bottom">
<div class="container">
<nav id="sitemap">
<ul class="row">
<li class="span3"><a href="index.html">Home</a>
<ul>
<li><a href="index.html#services">Rated Services</a></li>
<li><a href="topics.html#topics">Rated Topics</a></li>
</ul>
</li>
<li class="span3"><a href="about.html">About</a>
<ul>
<li><a href="about.html#contact">Contact us</a></li>
<li><a href="about.html#classification">Classification</a></li>
<li><a href="legal.html">Legal</a></li>
<li><a href="blog/index.html">Blog</a></li>
</ul>
</li>
<li class="span3"><a href="contribute.html">Contribute</a> <ul>
<li><a href="contribute.html#join">Join us</a></li>
<li><a href="get-involved.html">Get involved</a></li>
<li><a href="api.html">API</a></li>
</ul>
</li>
<li class="span3">Spread
<ul>
<li><a href="http://twitter.com/tosdr">Follow us on twitter</a></li>
<li><a href="http://flattr.com/thing/821090/ToSDR">Donate on Flattr</a></li>
<li><a href="http://github.com/didnotread/">Fork us on Github</a></li>
</ul>
</li>
</ul>
</nav>
<p id="credits"><strong><a href="http://tos-dr.info">Terms of Service; Didn't Read</a></strong> is a project inspired by Aza Raskin's <a href="http://azarask.in/blog/post/privacy-icons/">Privacy Icons</a> and EFF's <a href="http://github.com/pde/tosback2">TOSBack</a>. Also related: <a href="http://www.opennotice.org/">OpenNotice</a>.</p>
<p id="legalinfo"><strong>Nothing here should be considered legal advice</strong>. We express our opinion with no guarantee and we do not endorse any service in any way. Please refer to a qualified attorney for legal advice. <strong>Reading ToS;DR is in no way a replacement for reading the full terms to which you are bound.</strong> Disclosure: a list of donors and supporters <a href="thanks.html">is published</a>. <a href="legal.html">All legal information and Imprint</a>.</p>
<p id="licensing"><a href="http://tos-dr.info">ToS;DR</a> is Free Software, licensed under the GNU Affero General Public License (<a href="http://www.gnu.org/licenses/agpl-3.0-standalone.html" rel="license">AGPL-3.0</a>). Offer for <a href="https://github.com/didnotread/didnotread.org/zipball/master">Source (zip)</a>. The <code>.json</code> data inside the <a href="https://github.com/didnotread/didnotread.org/tree/master/services"><code>services/</code></a> and <a href="https://github.com/didnotread/didnotread.org/tree/master/points"><code>points/</code></a> directories are also licensed under the Attribution - Share Alike (<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">CC BY-SA 3.0</a>). Icons by <a href="http://glyphicons.com/glyphicons-licenses/">Glyphicons</a> used under a CC BY <a href="http://creativecommons.org/licenses/by/3.0/deed.en">3.0 Unported license</a>. Thumbs Up and Thumbs Down icons modified by Jan.</p>
<p id="technical" class="center"><span style="color:#999">Un</span>hosted by <a href="https://5apps.com/apps/4fd06274c439346fd700005e"><img src="img/unhostedby5apps.png" alt="5apps" /></a>
</div>
</footer>
<!-- <script src="bootstrap/js/bootstrap-twipsy.js"></script>-->
<script src="bootstrap/js/bootstrap-collapse.js"></script>
<!-- <script src="bootstrap/js/bootstrap-modal.js"></script>-->
<!-- <script src="bootstrap/js/bootstrap-transition.js"></script>-->
<!-- <script src="bootstrap/js/bootstrap-typeahead.js"></script>-->
<!-- <script src="bootstrap/js/bootstrap-alert.js"></script>-->
</body>
</html>