Page Comparison

<?xml version="1.0" encoding="utf-8"?>
<html>
<div style="float:right; margin: 0 0 10px 10px;">

Table of Contents

outline	true
indent	20px
style	none
printable	false

</div>

The The OpenSocial REST API allows client applications to view and publish users' OpenSocial data.
Your Your client application can use the OpenSocial REST API to request data items (such as Activity, Person, or AppData items), create new items, edit or delete existing items, and filter or modify results using query parameters.
In In addition to providing some background on the capabilities of the OpenSocial REST API, this document provides examples of basic REST API interactions using HTTP and JSON.
This This document does not cover the RPC protocol.
<h1 id="Audience">Audience</h1>
This

Audience

This document is intended for programmers who want to write client applications, using HTTP and JSON, that can interact with social networks that provide OpenSocial data.
This This document assumes that you understand the general idea of a REST API, and that you're familiar with the GUI of the social network you're working with.
This This document is very general; it tries to cover the REST API in general rather than any particular social network site. The social network your application interacts with may provide its own more specific documentation.
If If you're using a UNIX system and you want to try the examples in this document without writing any code, you may find the UNIX command-line utilities

...

curl

...

or

...

wget

...

useful; for more information, see the manual pages for those utilities.
<h1 id="GettingStarted">Getting started</h1>
<h2 id="CreatingAccount">Creating a user account</h2>
You

Getting started

Creating a user account

You may want to sign up for a user account with an appropriate OpenSocial social network for testing purposes.
<h2 id="AboutDataFormats">About data formats</h2>
Data

About data formats

Data provided by the REST API takes the form of an item or collection of items. Items can be represented in various formats; in particular, OpenSocial collections can take the form of JSON objects, Atom feeds, or non-Atom XML data.
This This document focuses on JSON, but if you want to use Atom or non-Atom XML instead (and the social network you're working with supports those formats), then everything works the same way; the data just appears in a different format.
<h2 id="AboutDataTypes">About OpenSocial data types</h2>
The

About OpenSocial data types

The REST API provides three types of data items:
<dl> Person
<dt>Person
<dd>Information Information about a person. A collection of these items represents a group of people, such as a given user's friends.
<dt>Activity Activity
<dd>Information Information about an activity performed by a user within the social network. A collection of these items represents an activity stream—a stream—a list of the activities the user has performed.
<dt>AppData AppData
<dd>An An item of data, such as a preference setting, stored by the social network on a user's behalf for a given application. A collection of these items might be the whole set of preferences for the application.
</dl>
For For more information about these data types, see the appropriate sections of this developer's guide. <h1 id="

Authenticating

...

with

...

OAuth

You You can access both public and private data using the OpenSocial REST API. Public collections don't require any authentication, but they are read-only. If you want to modify items or read private collections, then your client needs to authenticate first, using OAuth, and then provide credentials with requests. Every request for private data must be accompanied by OAuth authentication parameters.
OAuth OAuth is an open standard authentication protocol that allows applications to make authorized and authenticated API calls. With OAuth, your application doesn't need access to the user's username and password; instead, the application obtains obtains an authentication token from the social network site that your application can use to act on the user's behalf.
Most Most of the samples in subsequent sections of this document assume you're supplying the appropriate authentication, if needed.
When When a user first visits your application, they have not yet been authenticated. To authenticate them, your application performs the following general steps:
<ol>

...

Send a request to the social network site to acquire a generic OAuth "request token."

...

Send the user to the social network's authorization page so that they can authorize your request for access. After the user authorizes the request, the social network sends the user back to your client, using a URL that you specify. The request token that you acquired in step 1 is now authorized.

...

Send a request to the social network site to upgrade the authorized request token to an access token.

...

Store the access token securely, for future use.

...

Use the access token to perform actions on the user's behalf.

...

For more detailed information, see the OAuth Getting Started guide.

...

For an example of using OAuth, see Appendix A of the OAuth Core specification.

...

Discovering URLs

This document contains example URLs, but these examples are not guaranteed to work with all social networks.
Requests Requests to the REST protocol follow this general format:

HTTPVerb

Panel

Code Block


HTTPVerb http://

baseURL<

baseURL/

i>

serviceName/

serviceName/userID/selector?queryParameters

For example:

userID/selector?queryParameters

Panel
GET
No Format

For example:

Code Block


GET http://api.example.org

/people/

userID

userID/@friends?sortBy=updated

HoweverHowever, the specific formats of the URLs for a given social network are determined, and published, by the social network site.
To To find out what the URL formats are for a given social network, obtain the social network's discovery document.
You You can write your client in such a way that it obtains the discovery document each time it needs to perform a REST API operation; but it may be simpler to obtain the discovery document once, manually, while writing your client, and then specify the social network's actual URLs in your client.
The The discovery document is an XML file in XRDS, the same format used for OpenID and OAuth discovery. It declares what features the social network supports, and provides URL templates that a client can use to determine how to request a resource from the social network.
To To locate the discovery document, send an HTTP

...

GET

...

request to the social network's main URI (such as

...

http://example.org/

...

), with an

...

Accept

...

header set to

...

application/xrds+xml

...

.
The The social network returns either an

...

X-XRDS-Location

...

header pointing to the discovery document, or the document itself.
Here Here's an example of a discovery document:

<XRDS

Code Block

xml
	xml


<XRDS xmlns="xri://$xrds"&gt;>
  &lt;XRD<XRD xmlns:simple="http://xrds-simple.net/core/1.0" xmlns="xri://$XRD*($v*2.0)"
      xmlns:os="http://ns.opensocial.org/2008/opensocial" version="2.0"&gt;>
    &lt;Type&gt;xri<Type>xri://$xrds*simple&lt;/Type&gt;simple</Type>
    &lt;Service&gt;<Service>
      &lt;Type&gt;http<Type>http://ns.opensocial.org/2008/opensocial/people&lt;/Type&gt;people</Type>
      &lt;os<os:URI-Template&gt;httpTemplate>http://api.example.org/people/{guid}/{selector}{-prefix|/|pid}&lt;</os:URI-Template&gt;Template>
    &lt;/Service&gt;</Service>
    &lt;Service&gt;<Service>
      &lt;Type&gt;http<Type>http://ns.opensocial.org/2008/opensocial/groups&lt;/Type&gt;groups</Type>
      &lt;os<os:URI-Template&gt;httpTemplate>http://api.example.org/groups/{guid}&lt;</os:URI-Template&gt;Template>
    &lt;/Service&gt;</Service>
    &lt;Service&gt;<Service>
      &lt;Type&gt;http<Type>http://ns.opensocial.org/2008/opensocial/activities&lt;/Type&gt;activities</Type>
      &lt;os<os:URI-Template&gt;httpTemplate>http://api.example.org/activities/{guid}/{appid}/{selector}&lt;</os:URI-Template&gt;Template>
    &lt;/Service&gt;</Service>
    &lt;Service&gt;<Service>
      &lt;Type&gt;http<Type>http://ns.opensocial.org//2008/opensocial/appdata&lt;/Type&gt;appdata</Type>
       &lt;os<os:URI-Template&gt;httpTemplate>http://api.example.org/appdata/{guid}/{appid}/{selector}&lt;</os:URI-Template&gt;Template>
    &lt;/Service&gt;</Service>
    &lt;Service&gt;<Service>
      &lt;Type&gt;http<Type>http://ns.opensocial.org//2008/opensocial/messages&lt;/Type&gt;messages</Type>
      &lt;os<os:URI-Template&gt;httpTemplate>http://api.example.org/messages/{guid}/{selector}&lt;</os:URI-Template&gt;Template>
    &lt;/Service&gt;</Service>
  &lt;/XRD&gt;
&lt;/XRDS&gt;

...

</XRD>
</XRDS>

To find a specific resource, instantiate one of the URL templates by replacing the items in braces. For example, given the above discovery document, you might use the following URL to obtain a list of activities:


http://api.example.org/activities/1000/

Panelcode

No Format

(Where

...

1000

...

is a user ID for that social network.)
The The templates use standard URI Template syntax. For details about the placeholder names, such as guid, appidguid, appid, and selectorselector, see the OpenSocial REST API specification.
<h1 id="ManagingPersonItems">Managing user profile information</h1>
After

Managing user profile information

After authenticating, you can retrieve profile information about users.
A A Person item, also called a Person, contains a person's profile information.
A
A Person collection lists the people relevant to the specified user.
<h2 id="RetrievingPersonItems">Retrieving user information</h2>
The

Retrieving user information

The following sections describe how to retrieve user information, with and without query parameters.
You You can query a public collection without authentication. Therefore, you don't need to set the Authorization parameter when you retrieve data from a public Person collection.
<h3 id="RetrievingPerson">Retrieving

Retrieving a specific user's profile

...

information

To To retrieve a user's profile information, send an authenticated HTTP

...

GET

...

request to the following URL:


http://api.example.org

/people/

userID

userID/@self

Panelcode

No Format

...

Replace userID with any user's ID.
Note: For
Note: For most social networks, to obtain a user ID you'll need to first send an authenticated request that uses

...

@me

...

for the user ID, which tells the social network to return the profile information for the user whose credentials accompany the request.
On On receiving the request, the social network returns the user's profile information. It might look something like this:

Code Block

{
  &quot;entry&quot;"entry" : {
    &quot;id&quot;"id" : &quot;"example.org:34KJDCSKJN2HHF0DW20394&quot;",
    &quot;displayName&quot;"displayName" : &quot;Liz&quot;"Liz",
    &quot;name&quot;"name" : {&quot;unstructured&quot;"unstructured" : &quot;"Elizabeth Bennet&quot;"},
    &quot;gender&quot;"gender" : &quot;female&quot;"female"
  }
}

...

Retrieving a user's

...

contacts

You You can retrieve a list of a user's friends, or a list of all of their contacts, by changing the "selector" at the end of the URL.
To To retrieve a list of a user's friends, send a

...

GET

...

request to the following URL:


http://api.example.org

/people/

userID

userID/@friends

Panelcode

No Format

To To retrieve a list of all of a user's contacts, send a

...

GET

...

request to the following URL:


http://api.example.org

/people/

userID

userID/@all

Panelcode

No Format

...

Replace userID with any user's ID, or with

...

@me

...

to request the authenticated user's friends or contacts.
In In place of

...

@friends

...

or

...

@all

...

, you can specify a specific group ID to request user information about all of the people in a particular group. For example, a user might have defined a group named

...

dancers

...

that contains some of their contacts; your code could specify that group ID to retrieve a list of the members of that group.
In In response to any of these requests, the social network returns an HTTP

...

200

...

OK

...

status code and a collection containing user information in JSON format, one item for each member of the requested group. For example, if the user has only one friend, the friends collection might look like the following:

Code Block
{ "startIndex": 0, "totalResults": 1, "entry": [ { "id": "example.org:17MXBCSKJN2OZF0DW20916", "name": { "familyName": "Bennet", "givenName": "Jane" } } ] }

For For information about what each of those attributes means, see the OpenSocial REST API specification.
If If your request fails for some reason, the social network may return a different status code. For information about HTTP status codes, see the status codes section of the REST API specification.
<h3 id="RetrievingPersonWithQuery">Filtering

Filtering, sorting, and paginating lists of

...

people

The The OpenSocial REST API lets you specify various criteria to apply to the returned collection, such as requesting that the items be sorted in a particular order, or requesting that only a particular set of fields be returned for each Person in the collection.
For For example, to request that the returned items be ordered by last-updated date, add the

...

sortBy

...

parameter to the request URL:

 http://api.example.org

/people/

userID/selector

userID/selector?sortBy=updated

Panelcode
GET
No Format

When When you send that

...

GET

...

request, the social network returns an HTTP

...

200

...

OK

...

status code and a collection of people sorted by date.
Another Another example: if you want to break up your request to ensure that you only retrieve a limited number of people at a time (such as ten people per "page" of results), you can use the

...

count

...

and

...

startIndex

...

query parameters to retrieve a list of people one page at a time.
For For more information about the supported query parameters, see Query parameter reference.
<h2 id="CreatingPersonItems">Creating

Creating, updating, and deleting profile

...

information

The The OpenSocial REST protocol allows for social networks to support creating, updating, and deleting Person items using the

...

POST

...

,

...

PUT

...

, and

...

DELETE

...

HTTP verbs (respectively). However, most social networks don't support those actions, so this guide doesn't cover them.
<h1 id="ManagingActivityItems">Managing Activity items</h1>
After
Managing Activity items

After authenticating, you can publish and retrieve Activity items.
An
An Activity contains information about an activity performed by the user within the social network.
An An Activity collection lists the Activity items relevant to the user.
<h2 id="CreatingActivityItems">Creating Activity items</h2>
First

Creating Activity items

First, create a JSON representation of the Activity to publish. The JSON might look like this:

Code Block

{
  "title" : { "type" : "html",
              "value" : "&lt;a<a href=\"foo\"&gt;Dancing>Dancing with Darcy&lt;/a&gt;Darcy</a>"
            }
  "updated" : "2008-02-20T23:35:37.266Z",
  "body" : "Attending a dance at the Pavilion with Darcy.",
  "bodyId" : "383777272"
  "url" : "http://api.example.org/activity/feeds/.../af3778"
  "userId" : "example.org:34KJDCSKJN2HHF0DW20394"
}

To To publish this entry, send it to the Activity items URL as follows:
<ol>

...

Place your JSON code in the body of a new

...

POST

...

request, using the

...

application/json

...

content type.

...

Instantiate the Activity items URL, using the URL template specified in the discovery document.

...

Post the request to the URL, with appropriate authentication.

...

The social network creates an Activity using the entry you sent, then returns an HTTP

...

201

...

Created

...

status code, along with a copy of the new Activity. The Activity returned is the same one you sent, but it also contains some information generated and added by the social network.

...

If your request fails for some reason, the social network may return a different status code. For information about HTTP status codes, see the REST API specification.

...

Retrieving Activity items

The following two sections describe how to retrieve a collection of Activity items, with and without query parameters.
You You can query a public collection without authentication. Therefore, you don't need to set the Authorization parameter when you retrieve Activity items from a public Activity stream.
<h3 id="RetrievingActivityWithoutQuery">Retrieving all Activity items</h3>
To

Retrieving all Activity items

To retrieve the user's Activity items, send an HTTP

...

GET

...

request to the Activity URL. The social network returns a collection of the appropriate Activity items. For example, to get a list of Activity items for a given user, send the following HTTP request to the social network (with the appropriate value in place of

...

userID

...

, of course):

 http://api.example.org

/activities/

userID<

userID/

i>/appID/selector

Panelcode
GET
No Format

...

appID/selector

Note: In an authenticated request, you can substitute

...

@me

...

for the user ID, which tells the social network to return the collection of Activity items for the user whose credentials accompany the request.
The The selector can be any of the following:
<dl>
<dt>

...

@self
<dd>The The user's activities.
<dt>

...

@friends
<dd>All All of the activities from all of the user's friends.
<dt>

...

@all
<dd>All All of the activities from all of the user's contacts.
<dt>groupID groupID
<dd>All All of the activities from everyone in the specified group.
<dt>

...

@self/activityID
activityID
<dd>A A specific activity item for the specified user. (Usually your client acquires the ID of a particular activity item by examining the full

...

@self

...

collection.)
</dl>
The The social network then returns an HTTP

...

200 OK

...

status code and a collection containing the Activity items, in JSON format.
The The following is an example of an Activity items collection that contains only one Activity.

Code Block

{
  "author" : "example.org:58UIDCSIOP233FDKK3HD44",
  "link" : {"rel" : "next", "href" : "<nowiki>httphttp://api.example.org<org/nowiki>/..." },
  "totalResults" : 100,
  "startIndex" : 1
  "itemsPerPage" : 10
  "entry" : [
    {
      "id" : "http://example.org/activities/example.org:87ead8dead6beef/self/af3778",
      "title" : { "type" : "html",
                  "value" : "&lt;a<a href=\"foo\"&gt;some activity&lt;/a&gt;>some activity</a>"
                }
      "updated" : "2008-02-20T23:35:37.266Z",
      "body" : "Some details for some activity",
      "bodyId" : "383777272"
      "url" : "<nowiki>httphttp://api.example.org</nowiki>org/activity/feeds/.../af3778"
      "userId" : "example.org:34KJDCSKJN2HHF0DW20394"
    }
  ]
}

For For information about what each of those attributes means, see the OpenSocial REST API specification.
If If your request fails for some reason, the social network may return a different status code. For information about HTTP status codes, see the REST API specification.
<h3 id="RetrievingActivityWithQuery">Filtering

Filtering, sorting, and paginating Activity

...

items

The The OpenSocial REST API lets you specify various criteria to apply to the returned collection, such as requesting that the items be sorted in a particular order, or requesting that only a particular set of fields be returned for each Activity in the collection.
For For example, to request that Activity items be ordered by last-updated date, add the

...

orderby

...

parameter to the request URL:

 http://api.example.org

/activities/

userID

userID?orderby=updated

Panelcode
GET
No Format

When When you send that

...

GET

...

request, the social network returns an HTTP

...

200

...

OK

...

status code and a collection of Activity items sorted by date.
For For more information about the supported query parameters, see Query parameter reference.
<h2 id="UpdatingActivityItems">Updating

Updating and deleting Activity

...

items

The The OpenSocial REST protocol allows for social networks to support updating and deleting Activity items using the

...

PUT

...

and

...

DELETE

...

HTTP verbs (respectively). However, most social networks don't support those actions, so this guide doesn't cover them.
<h1 id="ManagingAppDataItems">Managing AppData items</h1>
After

Managing AppData items

After authenticating, you can publish and retrieve AppData items.
An An AppData item is an item of data, such as a preference setting, stored by the social network site on the user's behalf.
An
An AppData collection lists the AppData items relevant to the user.
<h2 id="CreatingAppDataItems">Creating AppData items</h2>
First

Creating AppData items

First, create a JSON representation of the AppData item to publish. The JSON might look like this:

Code Block
{ "example.org:34KJDCSKJN2HHF0DW20394" : {"pokes" : 3, "last_poke" : "2008-02-13T18:30:02Z" } }

To To publish this entry, send it to the AppData items URL as follows:
<ol>

...

Place your JSON code in the body of a new

...

POST

...

request, using the

...

application/json

...

content type.

...

Instantiate the AppData items URL, using the URL template specified in the discovery document.

...

Post the request to the URL, with appropriate authentication.

...

The social network creates an AppData item using the entry you sent, then returns an HTTP

...

201

...

Created

...

status code, along with a copy of the new AppData item. The AppData item returned is the same one you sent, but it also contains some information generated and added by the social network.

...

If your request fails for some reason, the social network may return a different status code. For information about HTTP status codes, see the REST API specification.

...

Retrieving AppData items

The following two sections describe how to retrieve a collection of AppData items, with and without query parameters.
You You can query a public collection without authentication. Therefore, you don't need to set the Authorization parameter when you retrieve AppData items from a public application data stream.
<h3 id="RetrievingAppDataWithoutQuery">Retrieving all AppData items</h3>
To

Retrieving all AppData items

To retrieve the user's AppData items, send an HTTP

...

GET

...

request to the AppData item URL. The social network returns a collection of the appropriate AppData items. For example, to get a list of your application's AppData items for a given user, send the following HTTP request to the social network (with the appropriate value in place of

...

userID

...

, of course):

 http://api.example.org

/appdata/

userID<

userID/

i>/appID/selector

Panelcode
GET
No Format

...

appID/selector

Note: In an authenticated request, you can substitute

...

@me

...

for the user ID, which tells the social network to return the collection of AppData items for the user whose credentials accompany the request.
The
The selector can be any of the following:
<dl>
<dt>

...

@self
<dd>The The user's application data.
<dt>

...

@friends
<dd>All All of the application data from all of the user's friends.
<dt>

...

@all
<dd>All All of the application data from all of the user's contacts.
<dt>groupID groupID
<dd>All All of the application data from everyone in the specified group. <dt>
</dl>
The

The social network then returns an HTTP

...

200

...

OK

...

status code and a collection containing the AppData items, in JSON format.
The The following is an example of an AppData items collection for a user's friends.

Code Block
{ "entry": { "10459228050876679741": { "letters": "2", "last_letter_date": "2008-10-15T10:01:00Z" }, "07365476160138082838": { "letters": "1", "last_letter_date": "2008-09-28T08:20:20Z" } } }

Note Note that a single AppData entry object can contain AppData for multiple users, and there can be multiple pieces of data for each user.
If If your request fails for some reason, the social network may return a different status code. For information about HTTP status codes, see the REST API specification.
<h3 id="RetrievingAppDataWithQuery">Filtering

Filtering, sorting, and paginating AppData

...

items

The The OpenSocial REST API lets you specify various criteria to apply to the returned collection, such as requesting that the items be sorted in a particular order, or requesting that only a particular set of fields be returned for each AppData item in the collection.
For
For example, to request that AppData items be ordered by last-updated date, add the

...

orderby

...

parameter to the request URL:

 http://api.example.org

/appdata/

userID<

userID/

i>/appID/selector

appID/selector?orderby=updated

Panelcode
GET
No Format

When When you send that

...

GET

...

request, the social network returns an HTTP

...

200

...

OK

...

status code and a collection of AppData items sorted by date.
For For more information about the supported query parameters, see Query parameter reference.
<h2 id="UpdatingAppDataItems">Updating AppData items</h2>
To

Updating AppData items

To update an existing AppData item, first you retrieve the AppData item you want to update, then you modify it, and then you send an authenticated

...

PUT

...

request, with the updated data in the request body, to the AppData item's URL.
For For example, say you've retrieved the following AppData item:

Code Block
{ "example.org:34KJDCSKJN2HHF0DW20394" : {"pokes" : 3, "last_poke" : "2008-02-13T18:30:02Z" } }

Modify Modify it as follows:

Panelcode


  "example.org:34KJDCSKJN2HHF0DW20394" : {"pokes" :

4

 4, "last_poke" : "

2008

2008-03-13T20:30:

02Z

02Z" }

Then Then use

...

PUT

...

to send the new AppData item to the AppData item URL. The social network replaces the original AppData item with the newly modified one.
Troubleshooting
Troubleshooting Tip: Some firewalls block HTTP

...

PUT

...

messages. To get around this, you can include an

...

X-HTTP-Method-Override:

...

PUT

...

header in a

...

POST

...

request.
<h2 id="DeletingAppDataItems">Deleting AppData items</h2>
To

Deleting AppData items

To delete an AppData item, send an authenticated

...

DELETE

...

request to the AppData item's URL.
Troubleshooting Tip
Troubleshooting Tip: Some firewalls block HTTP

...

DELETE

...

messages. To get around this, you can include an

...

X-HTTP-Method-Override:

...

DELETE

...

header in a

Code Block
POST

request.
NotePOST request.
Note: To update existing AppData items, see Updating AppData items; don't update by deleting AppData items and then re-adding them.
<h1 id="Parameters">Appendix

Appendix: Query parameter

...

reference

The The OpenSocial REST API supports the following query parameters:
<dl> count
<dt>count
<dd>The The number of items per page, for a paged collection

...

. A social network may have a default value for this parameter.
<dt>fields fields
<dd>A A comma-separated list of fields to include in the representation. A social network may have a default value for this parameter; if you want the complete set of fields included, then set

...

fields

...

to

...

@all

...

.
<dt>filterBy filterBy
<dd>The The field to apply the

...

filterOp

...

and

...

filterValue

...

parameters to.
<dt>filterOp filterOp
<dd>The The operation to use on the

...

filterBy

...

field when filtering. Defaults to

...

contains

...

. Valid values are

Code Block
contains

,

Code Block
equals

,

Code Block
startsWith

, and

Code Block
present

.
<dt>filterValue
<dd>The contains, equals, startsWith, and present.
filterValue
The value to use with

...

filterOp

...

when filtering.
<dt>format format
<dd>The The data format to use, such as

...

json

...

(the default) or

...

atom

...

.
<dt>indexBy indexBy
<dd>Indicates Indicates that the specified field should be used as an index in the returned JSON mapping.
<dt>networkDistance networkDistance
<dd>Indicates Indicates that the returned collection should include results for all friends up to this many links away.
<dt>sortBy sortBy
<dd>The The field to use in sorting.
<dt>sortOrder sortOrder
<dd>The The order in which to sort entries:

...

ascending

...

(the default) or

...

descending

...

.
<dt>startIndex startIndex
<dd>The The 1-based index of the first result to be retrieved (for paging).
<dt>updatedSince updatedSince
<dd>The The date to filter by; returns only items with an updated date equal to or more recent than the specified value.
</dl>
Some Some social networks may not support all parameters.
For For more information about query parameters, see the REST API specification.</html>

Versions Compared

Old Version 1

New Version 2

Key

Audience

Getting started

Creating a user account

About data formats

About OpenSocial data types

Authenticating

with

OAuth

Discovering URLs

Managing user profile information

Retrieving user information

Retrieving a specific user's profile

information

Retrieving a user's

contacts

Filtering, sorting, and paginating lists of

people

Creating, updating, and deleting profile

information

Creating Activity items

Retrieving Activity items

Retrieving all Activity items

Filtering, sorting, and paginating Activity

items

Updating and deleting Activity

items

Managing AppData items

Creating AppData items

Retrieving AppData items

Retrieving all AppData items

Filtering, sorting, and paginating AppData

items

Updating AppData items

Deleting AppData items

Appendix: Query parameter

reference