Database.com Chatter REST API Developer's Guide - Salesforce.com

Introducing Chatter REST API
Building the Chatter API Resource URL
application. When polling for feed updates or private messages, use the /feeds/news/me |userId/is-modified
endpoint and do not exceed one poll per minute.
Note: Though the Is-Modified resource is generally available, your organization may not have permission to
use it automatically. If you can’t access this resource, contact your salesforce.com representative and ask about
the “Enabled Chatter Feed Polling” permission.
If an application uses a regular session ID for authentication instead of an OAuth token, that application's requests count
against a general allocation of requests where there is no associated OAuth consumer key. However, any other application
the user accesses, that is also authenticating with session IDs, is contending for the same allocation of requests . For
example, your app connects a user to Database.com using a regular session ID. This user now has the same number of
requests regardless of the app they are using. They no longer have a separate request limit per application: all applications
are now using the same limit. Because of this, we recommend clients use OAuth tokens whenever feasible.
Note: Stated limits aren't a promise that the specified resource is available at its limit in all circumstances. For
example, load, performance and other system issues might prevent some limits from being reached. The stated
limit may change without notice. Applications should make efficient use of available requests and gracefully
handle the 503 error code.
Default HTML Entity Encoding
Chatter API strings are minimally HTML entity encoded by default, which is suitable in most cases for display between
HTML tags, but not necessarily in other HTML contexts.
For non-HTML contexts, such as native mobile applications, Chatter API clients may request raw (unencoded) output
by setting the X-Chatter-Entity-Encoding HTTP header in your request to false.
For more information, see Response Body Encoding on page 262.
Feed Item Templates
Feed item templates make feed items easier to render by defining their layout. The Feed Item Attachment: Basic Template
is currently used for feed items that announce the creation of a group (the CollaborationGroupCreated feed item
type). However, Salesforce may reflect other events in the Basic Template in the future.
Building the Chatter API Resource URL
Note: Communities are available as a pilot program. Contact your salesforce.com representative to find out if your
organization qualifies for the community pilot.
Access all Chatter API resources by using the URI for your company's instance, combined with version information, and the
URI for the resource.
For example, building a URL, if your instance is:
https://na1.database.com/
And the version information is:
/services/data/v27.0/
7