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

Introducing Chatter REST API
Understanding Chatter API Resources
2. The system authenticates the user and client app.
3. Request Chatter API resources using an HTTP request.
4. The system returns an HTTP return code. Additional information (such as a Chatter API response body) is optionally
included in the response.
Each resource in Chatter API is a URI used with an HTTP method (such as GET, POST, DELETE, or HEAD). Each
resource represents something in Chatter, such as a user's news feed, or the comments on a post.
Many of the resources use either a specified userId or the keyword me to indicate the current, logged-in user. For example, to
return the user-profile information for the current, logged-in user, use the following resource:
/chatter/users/me
You could also specify a particular user by user Id:
/chatter/users/005D0000001GLoh
When you successfully access a resource, a response body is returned in JSON or XML. By default, JSON is returned. Each
response body may contain one or more response bodies. For example, the following is the response body of the above resource
(users). Note that it includes other response bodies as well, such as address, current status, and phone numbers:
Property
Type
Description
Since Version
aboutMe
String
Text from user's profile
23.0
address
Address
Address
23.0
chatterActivity
Chatter Activity
Chatter activity statistics
23.0
chatterInfluence
Chatter Influence
User’s influence rank
23.0
companyName
String
Company name
23.0
currentStatus
User Status
Note: This property is no longer available
as of version 25.0.
23.0–25.0
User's current status
email
String
User's email address
23.0
firstName
String
User's first name
23.0
followersCount
Integer
Number of users following this user
23.0
followingCounts
Following Counts
Information about items the user is following
23.0
groupCount
Integer
Number of groups user is following
23.0
id
String
18-character Id of the user
23.0
isActive
Boolean
true if user is active, false otherwise
23.0
isChatterGuest
Boolean
Note: This property is no longer available
as of version 26.0. Use the userType
property instead.
23.0–25.0
3