GNUsocial/gnu-social-v2-archive-activitypub-plugin-doc
Archived
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HTTP requests shall follow the ActivityPub standard

Browse Source 
https://www.w3.org/TR/activitypub/#retrieving-objects
This commit is contained in:
Diogo Cordeiro 2018-05-11 11:32:45 +00:00
parent d264d8fbf7
commit c3f9df648a
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@ -16,6 +16,13 @@ ActivityPub Plugin for GNU Social Doc
- [Profile](#profile)
- [Tag](#tag)
###### Retrieving objects
The HTTP GET method may be dereferenced against an object's `id` property to retrieve the activity.
The plugin supports HTTP content negotiation as defined in [RFC7231](https://tools.ietf.org/html/rfc7231) in every endpoint suffixed with .json .
The plugin always presents ActivityStreams object representation in response to every request.
The client MUST specify an `Accept` header with the `application/ld+json; profile="https://www.w3.org/ns/activitystreams"` media type in order to retrieve the activity.
###### Selecting ranges
For most `GET` operations that return arrays, the query parameters `max_id` and `since_id` can be used to specify the range of IDs to return.
@ -55,7 +62,7 @@ Return:
| `totalItems` | Total number of followers | no | int32 |
| `prev` | Previous page URL | yes | string |
| `next` | Next page URL | yes | string |
| `orderedItems` | The URL of each follower | no | Array of strings |
| `orderedItems` | The URL of each profile | no | Array of strings |
### Following Collection
@ -78,7 +85,7 @@ Return:
| `totalItems` | Number of persons the actor follows | no | int32 |
| `prev` | Previous page URL | yes | string |
| `next` | Next page URL | yes | string |
| `orderedItems` | The URL of each follower | no | Array of strings |
| `orderedItems` | The URL of each profile | no | Array of strings |
### Liked Collection
@ -107,6 +114,7 @@ Return:
#### Fetching an Actor's profile:
GET :nickname
GET :nickname/profile.json
Returns a [Profile](#profile).