]> git.mxchange.org Git - friendica.git/blob - doc/API-Mastodon.md
Merge pull request #8977 from annando/fix-contact-search
[friendica.git] / doc / API-Mastodon.md
1 # Mastodon API
2
3 * [Home](help)
4   * [Using the APIs](help/api)
5
6 ## Overview
7
8 Friendica provides the following endpoints defined in [the official Mastodon API reference](https://docs.joinmastodon.org/api/).
9
10 Authentication is the same as described in [Using the APIs](help/api#Authentication).
11
12 ## Entities
13
14 These endpoints use the [Mastodon API entities](https://docs.joinmastodon.org/entities/).
15
16 ## Implemented endpoints
17
18 - [`GET /api/v1/custom_emojis`](https://docs.joinmastodon.org/methods/instance/custom_emojis/)
19     - Doesn't return unicode emojis since they aren't using an image URL
20
21
22 - [`GET /api/v1/follow_requests`](https://docs.joinmastodon.org/methods/accounts/follow_requests#pending-follows)
23     - Returned IDs are specific to follow requests
24 - [`POST /api/v1/follow_requests/:id/authorize`](https://docs.joinmastodon.org/methods/accounts/follow_requests#accept-follow)
25     - `:id` is a follow request ID, not a regular account id
26 - [`POST /api/v1/follow_requests/:id/reject`](https://docs.joinmastodon.org/methods/accounts/follow_requests#reject-follow)
27     - `:id` is a follow request ID, not a regular account id
28 - `POST /api/v1/follow_requests/:id/ignore`
29     - Friendica-specific, hides the follow request from the list and prevents the remote contact from retrying.
30     - `:id` is a follow request ID, not a regular account id
31     - Returns a [Relationship](https://docs.joinmastodon.org/entities/relationship) object.
32
33
34 - [`GET /api/v1/instance`](https://docs.joinmastodon.org/methods/instance#fetch-instance)
35 - [`GET /api/v1/instance/peers`](https://docs.joinmastodon.org/methods/instance#list-of-connected-domains)
36
37 ## Non-implemented endpoints
38
39 - [`GET /api/v1/instance/activity`](https://docs.joinmastodon.org/methods/instance#weekly-activity)