aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/index.rst49
1 files changed, 30 insertions, 19 deletions
diff --git a/docs/index.rst b/docs/index.rst
index 8766dd8..90cc8e2 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -228,6 +228,20 @@ Card dicts
228 'provider_url': # URL pointing to the embeds provider 228 'provider_url': # URL pointing to the embeds provider
229 } 229 }
230 230
231Instance dicts
232~~~~~~~~~~~~~~
233.. code-block:: python
234
235 mastodon.instance()
236 # Returns the folowing dictionary
237 {
238 'description': # A brief instance description set by the admin
239 'email': # The admin contact e-mail
240 'title': # The instances title
241 'uri': # The instances URL
242 'version': # The instances mastodon version
243 }
244
231App registration and user authentication 245App registration and user authentication
232---------------------------------------- 246----------------------------------------
233Before you can use the mastodon API, you have to register your 247Before you can use the mastodon API, you have to register your
@@ -248,7 +262,7 @@ methods for this are provided.
248.. automethod:: Mastodon.log_in 262.. automethod:: Mastodon.log_in
249.. automethod:: Mastodon.auth_request_url 263.. automethod:: Mastodon.auth_request_url
250 264
251Reading data: Instance 265Reading data: Instances
252----------------------- 266-----------------------
253This function allows you to fetch information associated with the 267This function allows you to fetch information associated with the
254current instance. 268current instance.
@@ -300,9 +314,18 @@ Reading data: Follows
300 314
301.. automethod:: Mastodon.follows 315.. automethod:: Mastodon.follows
302 316
317Reading data: Favourites
318------------------------
319
320.. automethod:: Mastodon.favourites
321
322Reading data: Follow requests
323-----------------------------
324
325.. automethod:: Mastodon.follow_requests
326
303Reading data: Searching 327Reading data: Searching
304----------------------- 328-----------------------
305This function allows you to search for content.
306 329
307.. automethod:: Mastodon.search 330.. automethod:: Mastodon.search
308 331
@@ -317,25 +340,8 @@ muted or blocked by the logged in user.
317 340
318Reading data: Reports 341Reading data: Reports
319------------------------------ 342------------------------------
320These functions allow you to retrieve information about reports filed
321by the authenticated user, and file a report against a user.
322 343
323.. automethod:: Mastodon.reports 344.. automethod:: Mastodon.reports
324.. automethod:: Mastodon.report
325
326Reading data: Favourites
327------------------------
328This function allows you to get information about statuses favourited
329by the authenticated user.
330
331.. automethod:: Mastodon.favourites
332
333Reading data: Follow requests
334-----------------------------
335This function allows you to get a list of pending incoming follow
336requests for the authenticated user.
337
338.. automethod:: Mastodon.follow_requests
339 345
340Writing data: Statuses 346Writing data: Statuses
341---------------------- 347----------------------
@@ -379,6 +385,11 @@ to attach media to statuses.
379 385
380.. automethod:: Mastodon.media_post 386.. automethod:: Mastodon.media_post
381 387
388Writing data: Reports
389---------------------
390
391.. automethod:: Mastodon.report
392
382Streaming 393Streaming
383--------- 394---------
384These functions allow access to the streaming API. 395These functions allow access to the streaming API.
Powered by cgit v1.2.3 (git 2.41.0)