Chatter REST API 開発者ガイド
jHTML からの静的アセットの直接要求およびフォーム要求の直接投稿
Salesforce でホストされない HTML ページでは、ユーザやグループ画像を表示したり、フォームに添付ファイルを投稿したりするのが困難でした。理由は、これらのアセットの URL で認証が必要であるからです。この認証は、ページが Salesforce でホストされるときに、セッション Cookie によって提供されます。Salesforce でホストされないページは、セッション Cookie にアクセスできません。また、HTML のコンテキスト <img>、<a>、および <form> から OAuth トークンを渡すこともできません。
この問題を解決するには、自己認証を行うべアラートークン URL を要求します。べアラートークン URL は、リソースへのアクセスを提供するべアラートークンが付加された Chatter REST API リソースです。ベアラートークン URL はそのまま使用します。パラメータを追加または削除しないでください。パラメータを追加または削除すると、エラーが発生します。次の操作を行うには、<img>、<a>、および <form> タグでべアラートークン URL を使用します。
- Chatter ユーザプロファイルの画像およびファイル、ファイルやダッシュボードのプレビューなどの静的な Chatter REST API アセットの要求
- 添付ファイルがあるフィード項目やコメント、またはユーザプロファイル写真の更新など、ファイルが添付されている場合の Chatter REST API へのフォーム要求の投稿
静的アセットの要求またはフォーム要求の投稿を行うには、べアラートークン URL を返すリソースを要求します。次に、べアラートークン URL を使用して、リソースを要求します。
-
べアラートークン URL を含むレスポンスボディのプロパティを使用して、リソースを要求します。
- Banner Photo — bannerPhotoUrl、url*
- Comment Page — currentPageUrl*
- Content Capability — downloadUrl、externalDocumentUrl、renditionUrl、repositoryFileUrl
- Feed — feedElementPostUrl*、feedElementsUrl*、feedItemsUrl*
- Feed Item — photoUrl
- Feed Item Attachment: Content — downloadUrl、externalDocumentUrl、renditionUrl、repositoryFileUrl
- Feed Item Attachment: Dashboard — fullSizeImageUrl、thumbnailUrl
- File Detail — downloadUrl、externalDocumentUrl、renditionUrl、renditionUrl240By180、renditionUrl720By480、repositoryFileUrl
- File Preview URL — previewUrl
- File Summary — downloadUrl、externalDocumentUrl、renditionUrl、renditionUrl240By180、renditionUrl720By480、repositoryFileUrl
- File Summary Page — currentPageUrl*
- Icon — url
- Mention Completion — photoUrl
- Message Segment: Inline Image — url*
- Photo — largePhotoUrl、smallPhotoUrl、url*
- Repository File Detail — downloadUrl
- Repository File Summary — downloadUrl
-
true の値を使用して、X-Connect-Bearer-Urls 要求ヘッダーを渡します。
1X-Connect-Bearer-Urls: true -
レスポンスボディからベアラートークン URL を解析します。それを HTML タグで使用して、静的アセットの要求またはフォーム要求の投稿を行います。
べアラートークン URL には、次の特性があります。
- べアラートークンは、特定の URL にのみ適しています。クエリパラメータを追加したり、並び替えたりすると、URL が無効になります。
- べアラートークンの Time to Live (TTL) は 20 分です。トークンの有効期限が切れた場合、再度要求します。
- べアラートークン URL への要求は、べアラートークン URL を返したリソースを要求したユーザとして認証されます。