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

Introducing Chatter REST API
Requesting Static Assets and Posting Forms Directly from
HTML
• Post form requests to Chatter API when files are attached, for example, feed items or comments with a file attachment,
or user profile photo updates.
To request static assets or post form requests, request a resource that returns a bearer token URL. Then use the bearer token
URL to request the resource.
1. Request a resource with a response body property that contains a bearer token URL:
• Photo—largePhotoUrl, smallPhotoUrl, url*
• Feed Item Attachment-Dashboard—fullSizeImageUrl, thumbNailUrl
• Comment Page—currentPageUrl*
• Feed Item—photoUrl
• Feed—feedItemsUrl*
• Feed Item Attachment-Content—downloadUrl, renditionUrl
• File Summary—downloadUrl, renditionUrl
• File Detail—downloadUrl, renditionUrl
*Use to POST or PUT for new items that include binary files: for example, a feed item or comment with a file attachment.
2. Pass the X-Connect-Bearer-Urls request header with a value of true:
X-Connect-Bearer-Urls: true
3. Parse the bearer token URL from the response body and use it in an HTML tag to request a static asset or to post a form
request.
Bearer token URLs have the following characteristics:
• The bearer token is good for the given URL only. Adding or reordering query parameters invalidates the URL.
• The bearer token has a time-to-live (TTL) of 20 minutes. If the token expires you must request it again.
• The request to the bearer token URL authenticates as the user who requested the resource that returned the bearer
token URL.
23