X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=doc%2Fapi.md;h=7d6f440c58c0008ecbaf909048c194f1b09c52ff;hb=84238e1b89c0a40cfd2dfa72972fdfc2f65c4fab;hp=fa9df1245eedacf55bec7104ec081fc17ad0438f;hpb=a677e12b50f0f4b148565611fd48ac9f3816206d;p=friendica.git
diff --git a/doc/api.md b/doc/api.md
index fa9df1245e..7d6f440c58 100644
--- a/doc/api.md
+++ b/doc/api.md
@@ -1,196 +1,302 @@
-Implemented API calls
+Friendica API
===
-The friendica API aims to be compatible to the [StatusNet API](http://status.net/wiki/Twitter-compatible_API) which aims to be compatible to the [Twitter API 1.0](https://dev.twitter.com/docs/api/1).
+The Friendica API aims to be compatible to the [GNU Social API](http://wiki.gnusocial.de/gnusocial:api) and the [Twitter API](https://dev.twitter.com/rest/public).
Please refer to the linked documentation for further information.
-General
----
+## Implemented API calls
+
+### General
+#### HTTP Method
+
+API endpoints can restrict the method used to request them.
+Using an invalid method results in HTTP error 405 "Method Not Allowed".
+
+In this document, the required method is listed after the endpoint name. "*" means every method can be used.
+
+#### Auth
-### Unsupported parameters
-* cursor: Not implemented in StatusNet
-* trim_user: Not implemented in StatusNet
-* contributor_details: Not implemented in StatusNet
-* place_id: Not implemented in StatusNet
-* display_coordinates: Not implemented in StatusNet
+Friendica supports basic http auth and OAuth 1 to authenticate the user to the api.
+
+OAuth settings can be added by the user in web UI under /settings/oauth/
+
+In this document, endpoints which requires auth are marked with "AUTH" after endpoint name
+
+#### Unsupported parameters
+* cursor: Not implemented in GNU Social
+* trim_user: Not implemented in GNU Social
+* contributor_details: Not implemented in GNU Social
+* place_id: Not implemented in GNU Social
+* display_coordinates: Not implemented in GNU Social
* include_rts: To-Do
-* include_my_retweet: Retweets in friendica are implemented in a different way
+* include_my_retweet: Retweets in Friendica are implemented in a different way
-### Different behaviour
+#### Different behaviour
* screen_name: The nick name in friendica is only unique in each network but not for all networks. The users are searched in the following priority: Friendica, StatusNet/GNU Social, Diaspora, pump.io, Twitter. If no contact was found by this way, then the first contact is taken.
* include_entities: Default is "false". If set to "true" then the plain text is formatted so that links are having descriptions.
-### Return values
+#### Return values
* cid: Contact id of the user (important for "contact_allow" and "contact_deny")
* network: network of the user
-account/verify_credentials
+#### Errors
+When an error occour in API call, an HTTP error code is returned, with an error message
+Usually:
+- 400 Bad Request: if parameter are missing or items can't be found
+- 403 Forbidden: if authenticated user is missing
+- 405 Method Not Allowed: if API was called with invalid method, eg. GET when API require POST
+- 501 Not Implemented: if requested API doesn't exists
+- 500 Internal Server Error: on other error contitions
+
+Error body is
+
+json:
+```
+ {
+ "error": "Specific error message",
+ "request": "API path requested",
+ "code": "HTTP error code"
+ }
+```
+
+xml:
+```
+
+ Specific error message
+ API path requested
+ HTTP error code
+
+```
+
+---
+### account/rate_limit_status (*; AUTH)
+
---
+### account/verify_credentials (*; AUTH)
+#### Parameters
-### Parameters
* skip_status: Don't show the "status" field. (Default: false)
* include_entities: "true" shows entities for pictures and links (Default: false)
-statuses/update, statuses/update_with_media
---
+### conversation/show (*; AUTH)
+Unofficial Twitter command. It shows all direct answers (excluding the original post) to a given id.
-### Parameters
-* title: Title of the status
-* status: Status in text format
-* htmlstatus: Status in HTML format
-* in_reply_to_status_id
-* lat: latitude
-* long: longitude
-* media: image data
-* source: Application name
-* group_allow
-* contact_allow
-* group_deny
-* contact_deny
-* network
+#### Parameter
+* id: id of the post
+* count: Items per page (default: 20)
+* page: page number
+* since_id: minimal id
+* max_id: maximum id
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
+#### Unsupported parameters
+* include_rts
* trim_user
-* place_id
-* display_coordinates
+* contributor_details
-users/search
---
+### direct_messages (*; AUTH)
+#### Parameters
+* count: Items per page (default: 20)
+* page: page number
+* since_id: minimal id
+* max_id: maximum id
+* getText: Defines the format of the status field. Can be "html" or "plain"
+* include_entities: "true" shows entities for pictures and links (Default: false)
-### Parameters
-* q: name of the user
-
-### Unsupported parameters
-* page
-* count
-* include_entities
+#### Unsupported parameters
+* skip_status
-users/show
---
+### direct_messages/all (*; AUTH)
+#### Parameters
+* count: Items per page (default: 20)
+* page: page number
+* since_id: minimal id
+* max_id: maximum id
+* getText: Defines the format of the status field. Can be "html" or "plain"
-### Parameters
-* user_id: id of the user
-* screen_name: screen name (for technical reasons, this value is not unique!)
-* include_entities: "true" shows entities for pictures and links (Default: false)
-
-statuses/home_timeline
---
-
-### Parameters
+### direct_messages/conversation (*; AUTH)
+Shows all direct messages of a conversation
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
-* exclude_replies: don't show replies (default: false)
-* conversation_id: Shows all statuses of a given conversation.
-* include_entities: "true" shows entities for pictures and links (Default: false)
-
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
+* getText: Defines the format of the status field. Can be "html" or "plain"
+* uri: URI of the conversation
-statuses/friends_timeline
---
+### direct_messages/new (POST,PUT; AUTH)
+#### Parameters
+* user_id: id of the user
+* screen_name: screen name (for technical reasons, this value is not unique!)
+* text: The message
+* replyto: ID of the replied direct message
+* title: Title of the direct message
-### Parameters
+---
+### direct_messages/sent (*; AUTH)
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
-* exclude_replies: don't show replies (default: false)
-* conversation_id: Shows all statuses of a given conversation.
+* getText: Defines the format of the status field. Can be "html" or "plain"
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
-
-statuses/public_timeline
---
-
-### Parameters
+### favorites (*; AUTH)
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
-* exclude_replies: don't show replies (default: false)
-* conversation_id: Shows all statuses of a given conversation.
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* trim_user
+#### Unsupported parameters
+* user_id
+* screen_name
+
+Favorites aren't displayed to other users, so "user_id" and "screen_name" are unsupported.
+Set this values will result in an empty array.
-statuses/show
---
+### favorites/create (POST,PUT; AUTH)
+#### Parameters
+* id
+* include_entities: "true" shows entities for pictures and links (Default: false)
-### Parameters
-* id: message number
-* conversation: if set to "1" show all messages of the conversation with the given id
+---
+### favorites/destroy (POST,DELETE; AUTH)
+#### Parameters
+* id
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_my_retweet
-* trim_user
+---
+### followers/ids (*; AUTH)
+#### Parameters
+* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)
+
+#### Unsupported parameters
+* user_id
+* screen_name
+* cursor
+
+Friendica doesn't allow showing followers of other users.
-statuses/retweet
---
+### friends/ids (*; AUTH)
+#### Parameters
+* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)
-### Parameters
-* id: message number
-* include_entities: "true" shows entities for pictures and links (Default: false)
+#### Unsupported parameters
+* user_id
+* screen_name
+* cursor
+
+Friendica doesn't allow showing friends of other users.
+
+---
+### help/test (*)
+
+---
+### media/upload (POST,PUT; AUTH)
+#### Parameters
+* media: image data
+
+---
+### oauth/request_token (*)
+#### Parameters
+* oauth_callback
-### Unsupported parameters
-* trim_user
+#### Unsupported parameters
+* x_auth_access_type
-statuses/destroy
---
+### oauth/access_token (*)
+#### Parameters
+* oauth_verifier
-### Parameters
+#### Unsupported parameters
+* x_auth_password
+* x_auth_username
+* x_auth_mode
+
+---
+### statuses/destroy (POST,DELETE; AUTH)
+#### Parameters
* id: message number
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* trim_user
+#### Unsupported parameters
+* trim_user
+
+---
+### statuses/followers (*; AUTH)
+
+#### Parameters
+
+* include_entities: "true" shows entities for pictures and links (Default: false)
-statuses/mentions
---
+### statuses/friends (*; AUTH)
-### Parameters
+#### Parameters
+
+* include_entities: "true" shows entities for pictures and links (Default: false)
+
+---
+### statuses/friends_timeline (*; AUTH)
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
+* exclude_replies: don't show replies (default: false)
+* conversation_id: Shows all statuses of a given conversation.
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
+#### Unsupported parameters
+* include_rts
+* trim_user
+* contributor_details
-statuses/replies
---
-
-### Parameters
+### statuses/home_timeline (*; AUTH)
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
+* exclude_replies: don't show replies (default: false)
+* conversation_id: Shows all statuses of a given conversation.
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
+#### Unsupported parameters
+* include_rts
+* trim_user
+* contributor_details
-statuses/user_timeline
---
+### statuses/mentions (*; AUTH)
+#### Parameters
+* count: Items per page (default: 20)
+* page: page number
+* since_id: minimal id
+* max_id: maximum id
+* include_entities: "true" shows entities for pictures and links (Default: false)
-### Parameters
-* user_id: id of the user
-* screen_name: screen name (for technical reasons, this value is not unique!)
+#### Unsupported parameters
+* include_rts
+* trim_user
+* contributor_details
+
+---
+### statuses/public_timeline (*; AUTH)
+#### Parameters
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
@@ -199,232 +305,498 @@ statuses/user_timeline
* conversation_id: Shows all statuses of a given conversation.
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
+#### Unsupported parameters
+* trim_user
-conversation/show
---
+### statuses/replies (*; AUTH)
+#### Parameters
+* count: Items per page (default: 20)
+* page: page number
+* since_id: minimal id
+* max_id: maximum id
+* include_entities: "true" shows entities for pictures and links (Default: false)
-Unofficial Twitter command. It shows all direct answers (excluding the original post) to a given id.
+#### Unsupported parameters
+* include_rts
+* trim_user
+* contributor_details
-### Parameters
-* id: id of the post
+---
+### statuses/retweet (POST,PUT; AUTH)
+#### Parameters
+* id: message number
+* include_entities: "true" shows entities for pictures and links (Default: false)
+
+#### Unsupported parameters
+* trim_user
+
+---
+### statuses/show (*; AUTH)
+#### Parameters
+* id: message number
+* conversation: if set to "1" show all messages of the conversation with the given id
+* include_entities: "true" shows entities for pictures and links (Default: false)
+
+#### Unsupported parameters
+* include_my_retweet
+* trim_user
+
+---
+### statuses/update, statuses/update_with_media
+#### Parameters
+* title: Title of the status
+* status: Status in text format
+* htmlstatus: Status in HTML format
+* in_reply_to_status_id
+* lat: latitude
+* long: longitude
+* media: image data
+* source: Application name
+* group_allow
+* contact_allow
+* group_deny
+* contact_deny
+* network
+* include_entities: "true" shows entities for pictures and links (Default: false)
+* media_ids: (By now only a single value, no array)
+
+#### Unsupported parameters
+* trim_user
+* place_id
+* display_coordinates
+
+---
+### statuses/user_timeline (*; AUTH)
+#### Parameters
+* user_id: id of the user
+* screen_name: screen name (for technical reasons, this value is not unique!)
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
+* exclude_replies: don't show replies (default: false)
+* conversation_id: Shows all statuses of a given conversation.
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* include_rts
-* trim_user
-* contributor_details
+#### Unsupported parameters
+
+* include_rts
+* trim_user
+* contributor_details
+
+---
+### statusnet/config (*)
-favorites
---
+### statusnet/conversation (*; AUTH)
+It shows all direct answers (excluding the original post) to a given id.
-### Parameters
+#### Parameter
+* id: id of the post
* count: Items per page (default: 20)
* page: page number
* since_id: minimal id
* max_id: maximum id
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
+---
+### statusnet/version (*)
+
+#### Unsupported parameters
* user_id
* screen_name
+* cursor
-Favorites aren't displayed to other users, so "user_id" and "screen_name". So setting this value will result in an empty array.
+Friendica doesn't allow showing followers of other users.
-account/rate_limit_status
---
+### users/search (*)
+#### Parameters
+* q: name of the user
-help/test
----
+#### Unsupported parameters
+* page
+* count
+* include_entities
-statuses/friends
---
+### users/show (*)
+#### Parameters
+* user_id: id of the user
+* screen_name: screen name (for technical reasons, this value is not unique!)
* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
+#### Unsupported parameters
* user_id
* screen_name
-* cursor
+* cursor
Friendica doesn't allow showing friends of other users.
-statuses/followers
+
+## Implemented API calls (not compatible with other APIs)
+
+
---
+### friendica/activity/
+#### parameters
+* id: item id
-* include_entities: "true" shows entities for pictures and links (Default: false)
+Add or remove an activity from an item.
+'verb' can be one of:
-### Unsupported parameters
-* user_id
-* screen_name
-* cursor
+- like
+- dislike
+- attendyes
+- attendno
+- attendmaybe
-Friendica doesn't allow showing followers of other users.
+To remove an activity, prepend the verb with "un", eg. "unlike" or "undislike"
+Attend verbs disable eachother: that means that if "attendyes" was added to an item, adding "attendno" remove previous "attendyes".
+Attend verbs should be used only with event-related items (there is no check at the moment)
-statusnet/config
----
+#### Return values
-statusnet/version
----
+On success:
+json
+```"ok"```
+
+xml
+```true```
+
+On error:
+HTTP 400 BadRequest
-friends/ids
---
+### friendica/group_show (*; AUTH)
+Return all or a specified group of the user with the containing contacts as array.
-### Parameters
-* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)
+#### Parameters
+* gid: optional, if not given, API returns all groups of the user
-### Unsupported parameters
-* user_id
-* screen_name
-* cursor
+#### Return values
+Array of:
-Friendica doesn't allow showing friends of other users.
+* name: name of the group
+* gid: id of the group
+* user: array of group members (return from api_get_user() function for each member)
-followers/ids
----
-Parameters
---
+### friendica/group_delete (POST,DELETE; AUTH)
+delete the specified group of contacts; API call need to include the correct gid AND name of the group to be deleted.
-* stringify_ids: Should the id numbers be sent as text (true) or number (false)? (default: false)
+#### Parameters
+* gid: id of the group to be deleted
+* name: name of the group to be deleted
-### Unsupported parameters
-* user_id
-* screen_name
-* cursor
+#### Return values
+Array of:
+
+* success: true if successfully deleted
+* gid: gid of the deleted group
+* name: name of the deleted group
+* status: âdeletedâ if successfully deleted
+* wrong users: empty array
-Friendica doesn't allow showing followers of other users.
-direct_messages/new
---
+### friendica/group_create (POST,PUT; AUTH)
+Create the group with the posted array of contacts as members.
-### Parameters
-* user_id: id of the user
-* screen_name: screen name (for technical reasons, this value is not unique!)
-* text: The message
-* replyto: ID of the replied direct message
-* title: Title of the direct message
+#### Parameters
+* name: name of the group to be created
-direct_messages/conversation
----
+#### POST data
+JSON data as Array like the result of "users/group_show":
-Shows all direct messages of a conversation
-### Parameters
-* count: Items per page (default: 20)
-* page: page number
-* since_id: minimal id
-* max_id: maximum id
-* getText: Defines the format of the status field. Can be "html" or "plain"
-* uri: URI of the conversation
+* gid
+* name
+* array of users
-direct_messages/all
----
+#### Return values
+Array of:
+
+* success: true if successfully created or reactivated
+* gid: gid of the created group
+* name: name of the created group
+* status: âmissing userâ | âreactivatedâ | âokâ
+* wrong users: array of users, which were not available in the contact table
-### Parameters
-* count: Items per page (default: 20)
-* page: page number
-* since_id: minimal id
-* max_id: maximum id
-* getText: Defines the format of the status field. Can be "html" or "plain"
-direct_messages/sent
---
+### friendica/group_update (POST)
+Update the group with the posted array of contacts as members (post all members of the group to the call; function will remove members not posted).
-### Parameters
-* count: Items per page (default: 20)
-* page: page number
-* since_id: minimal id
-* max_id: maximum id
-* getText: Defines the format of the status field. Can be "html" or "plain"
-* include_entities: "true" shows entities for pictures and links (Default: false)
+#### Parameters
+* gid: id of the group to be changed
+* name: name of the group to be changed
-direct_messages
----
+#### POST data
+JSON data as array like the result of âusers/group_showâ:
+
+* gid
+* name
+* array of users
+
+#### Return values
+Array of:
+
+* success: true if successfully updated
+* gid: gid of the changed group
+* name: name of the changed group
+* status: âmissing userâ | âokâ
+* wrong users: array of users, which were not available in the contact table
-### Parameters
-* count: Items per page (default: 20)
-* page: page number
-* since_id: minimal id
-* max_id: maximum id
-* getText: Defines the format of the status field. Can be "html" or "plain"
-* include_entities: "true" shows entities for pictures and links (Default: false)
-### Unsupported parameters
-* skip_status
-oauth/request_token
---
+### friendica/notifications (GET)
+Return last 50 notification for current user, ordered by date with unseen item on top
+
+#### Parameters
+none
-### Parameters
-* oauth_callback
+#### Return values
+Array of:
+
+* id: id of the note
+* type: type of notification as int (see NOTIFY_* constants in boot.php)
+* name: full name of the contact subject of the note
+* url: contact's profile url
+* photo: contact's profile photo
+* date: datetime string of the note
+* timestamp: timestamp of the node
+* date_rel: relative date of the note (eg. "1 hour ago")
+* msg: note message in bbcode
+* msg_html: note message in html
+* msg_plain: note message in plain text
+* link: link to note
+* seen: seen state: 0 or 1
-### Unsupported parameters
-* x_auth_access_type
-oauth/access_token
---
+### friendica/notifications/seen (POST)
+Set note as seen, returns item object if possible
-### Parameters
-* oauth_verifier
+#### Parameters
+id: id of the note to set seen
-### Unsupported parameters
-* x_auth_password
-* x_auth_username
-* x_auth_mode
+#### Return values
+If the note is linked to an item, the item is returned, just like one of the "statuses/*_timeline" api.
+
+If the note is not linked to an item, a success status is returned:
+
+* "success" (json) | "<status>success</status>" (xml)
+
+
+---
+### friendica/photo (*; AUTH)
+#### Parameters
+* photo_id: Resource id of a photo.
+* scale: (optional) scale value of the photo
+
+Returns data of a picture with the given resource.
+If 'scale' isn't provided, returned data include full url to each scale of the photo.
+If 'scale' is set, returned data include image data base64 encoded.
-Not Implemented API calls
-===
+possibile scale value are:
+
+* 0: original or max size by server settings
+* 1: image with or height at <= 640
+* 2: image with or height at <= 320
+* 3: thumbnail 160x160
+* 4: Profile image at 175x175
+* 5: Profile image at 80x80
+* 6: Profile image at 48x48
+
+An image used as profile image has only scale 4-6, other images only 0-3
+
+#### Return values
+
+json
+```
+ {
+ "id": "photo id"
+ "created": "date(YYYY-MM-GG HH:MM:SS)",
+ "edited": "date(YYYY-MM-GG HH:MM:SS)",
+ "title": "photo title",
+ "desc": "photo description",
+ "album": "album name",
+ "filename": "original file name",
+ "type": "mime type",
+ "height": "number",
+ "width": "number",
+ "profile": "1 if is profile photo",
+ "link": {
+ "": "url to image"
+ ...
+ },
+ // if 'scale' is set
+ "datasize": "size in byte",
+ "data": "base64 encoded image data"
+ }
+```
+
+xml
+```
+
+ photo id
+ date(YYYY-MM-GG HH:MM:SS)
+ date(YYYY-MM-GG HH:MM:SS)
+ photo title
+ photo description
+ album name
+ original file name
+ mime type
+ number
+ number
+ 1 if is profile photo
+
+
+ ...
+
+
+```
+
+---
+### friendica/photos/list (*; AUTH)
+
+Returns a list of all photo resources of the logged in user.
+
+#### Return values
+
+json
+```
+ [
+ {
+ id: "resource_id",
+ album: "album name",
+ filename: "original file name",
+ type: "image mime type",
+ thumb: "url to thumb sized image"
+ },
+ ...
+ ]
+```
+
+xml
+```
+
+
+ "url to thumb sized image"
+
+ ...
+
+```
+
+
+---
+## Not Implemented API calls
+The following API calls are implemented in GNU Social but not in Friendica: (incomplete)
-The following list is extracted from the [API source file](https://github.com/friendica/friendica/blob/master/include/api.php) (at the very bottom):
-* favorites/create
-* favorites/destroy
* statuses/retweets_of_me
* friendships/create
* friendships/destroy
* friendships/exists
* friendships/show
-* account/update_location
* account/update_profile_background_image
* account/update_profile_image
* blocks/create
* blocks/destroy
-The following are things from the Twitter API also not implemented in StatusNet:
-* statuses/retweeted_to_me
-* statuses/retweeted_by_me
+The following API calls from the Twitter API aren't implemented neither in Friendica nor in GNU Social:
+
+* statuses/mentions_timeline
+* statuses/retweets/:id
+* statuses/oembed
+* statuses/retweeters/ids
+* statuses/lookup
+* direct_messages/show
+* search/tweets
* direct_messages/destroy
-* account/end_session
+* friendships/no_retweets/ids
+* friendships/incoming
+* friendships/outgoing
+* friendships/update
+* friends/list
+* friendships/lookup
+* account/settings
* account/update_delivery_device
-* notifications/follow
-* notifications/leave
-* blocks/exists
-* blocks/blocking
-* lists
-
-Usage Examples
-===
-
-BASH / cURL
----
-
+* account/update_profile
+* account/update_profile_background_image
+* account/update_profile_image
+* blocks/list
+* blocks/ids
+* users/lookup
+* users/show
+* users/search
+* account/remove_profile_banner
+* account/update_profile_banner
+* users/profile_banner
+* mutes/users/create
+* mutes/users/destroy
+* mutes/users/ids
+* mutes/users/list
+* users/suggestions/:slug
+* users/suggestions
+* users/suggestions/:slug/members
+* favorites/list
+* lists/list
+* lists/statuses
+* lists/members/destroy
+* lists/memberships
+* lists/subscribers
+* lists/subscribers/create
+* lists/subscribers/show
+* lists/subscribers/destroy
+* lists/members/create_all
+* lists/members/show
+* lists/members
+* lists/members/create
+* lists/destroy
+* lists/update
+* lists/create
+* lists/show
+* lists/subscriptions
+* lists/members/destroy_all
+* lists/ownerships
+* saved_searches/list
+* saved_searches/show/:id
+* saved_searches/create
+* saved_searches/destroy/:id
+* geo/id/:place_id
+* geo/reverse_geocode
+* geo/search
+* geo/place
+* trends/place
+* trends/available
+* help/configuration
+* help/languages
+* help/privacy
+* help/tos
+* trends/closest
+* users/report_spam
+
+---
+
+---
+
+## Usage Examples
+### BASH / cURL
Betamax has documentated some example API usage from a [bash script](https://en.wikipedia.org/wiki/Bash_(Unix_shell) employing [curl](https://en.wikipedia.org/wiki/CURL) (see [his posting](https://betamax65.de/display/betamax65/43539)).
- /usr/bin/curl -u USER:PASS https://YOUR.FRIENDICA.TLD/api/statuses/update.xml -d source="some source id" -d status="the status you want to post"
-
-Python
----
+/usr/bin/curl -u USER:PASS https://YOUR.FRIENDICA.TLD/api/statuses/update.xml -d source="some source id" -d status="the status you want to post"
-The [RSStoFriedika](https://github.com/pafcu/RSStoFriendika) code can be used as an example of how to use the API with python.
-The lines for posting are located at [line 21](https://github.com/pafcu/RSStoFriendika/blob/master/RSStoFriendika.py#L21) and following.
+### Python
+The [RSStoFriedika](https://github.com/pafcu/RSStoFriendika) code can be used as an example of how to use the API with python. The lines for posting are located at [line 21](https://github.com/pafcu/RSStoFriendika/blob/master/RSStoFriendika.py#L21) and following.
- def tweet(server, message, group_allow=None):
- url = server + '/api/statuses/update'
- urllib2.urlopen(url, urllib.urlencode({'status': message,'group_allow[]':group_allow}, doseq=True))
+def tweet(server, message, group_allow=None):
+url = server + '/api/statuses/update'
+urllib2.urlopen(url, urllib.urlencode({'status': message,'group_allow[]':group_allow}, doseq=True))
There is also a [module for python 3](https://bitbucket.org/tobiasd/python-friendica) for using the API.