Force.com REST とStreaming API 〜 Winter '12リリース 〜
by Mitsuhiro Okamoto on 11月 4, 2011 at 10:03 午後
Spring '11で正式リリースされたREST APIと、現在パイロットリリース中のStreaming APIですが、Winter '12ではいくつかの機能追加及び変更がありました。以下詳細です。
REST APIでバイナリデータサポート改善
REST APIでのバイナリデータ(Blob)アップロードは従来50MBまででしたが(base64エンコード後のサイズ)、Winter '12リリースでは、multipartタイプを使用して500MBまでのblobファイルをアップロード出来るようになりました。
multipart/form-dataで送信されるデータの構造はEmailのraw dataと似た構成になっています。
--boundary_string
Content-Disposition: form-data; name="entity_document";
Content-Type: application/json
{
"Description" : "Marketing brochure for Q1 2011",
"Keywords" : "marketing,sales,update",
"FolderId" : "005D0000001GiU7",
"Name" : "Marketing Brochure Q1",
"Type" : "pdf"
}
--boundary_string
Content-Type: application/pdf
Content-Disposition: form-data; name="Body";
filename="2011Q1MktgBrochure.pdf"
ここにバイナリデータが入る
--boundary_string--
より詳しい情報は最新のREST APIドキュメント(英語)を御覧ください。
Streaming APIのOAuth tokenの扱い変更
Streaming APIのSummer '11リリースでは OAuth Tokenのやりとりにcookieを利用していましたが、Winter '12リリースではHTTP Authorizationヘッダに付与するように変更されました。
Authorization: OAuth sessionId
Streaming APIのcannelのprefixに"/topic/"が付与
Streaming APIのWinter '12でのもうひとつの大きな変更として、Bayeux(CometD)プロトコルで送信されるデータのcannel名には、"/topic/" + PushTopic名が用いられるようになりました。これによって、例えばjQueryのCometDバインドを使った例では以下の様に記述するようになります。
var cometdUrl = 'https://' + window.location.hostname + '/cometd/23.0/';
var auth = 'OAuth {!$Api.Session_ID}';
$.cometd.init({
url: cometdUrl,
requestHeaders: { Authorization: auth }
});
$.cometd.subscribe('/topic/AccountTopic', function(message) {
//ここに受信時の処理を記述
});
Streaming APIにおけるタイムアウトの変更
最後のWinter '12における大きな変更は、セッションタイムアウト値がhandshakes、connects、subscribesのたびにリセットされるようになりました。詳細は最新のSreaming APIドキュメント(英語)に記載されています。
Streaming APIはWinter '12の時点ではパイロットリリースとなっています。実際にDeveloper Editionで試してみたい方はセールスフォース・ドットコムへお問合せ下さい。
Streaming APIはまだ開発途中の機能ですが、リアルタイムなPush通知が実装できるようになるなど、非常に大きな可能性を秘めています。Database.comでも使えるようになる予定ですので、是非ご期待下さい。
Force.com REST API開発者ガイド日本語版公開
by Mitsuhiro Okamoto on 4月 26, 2011 at 04:58 午後
お待たせいたしました!!
Spring '11より正式リリースされたForce.com REST API開発者ガイドの日本語版PDFを公開致しました。
以下のページよりダウンロード頂けます。
http://wiki.developerforce.com/index.php/JP:Documentation#API
またREST API(及びOAuth)を利用したサンプルや紹介記事なども以下にございますので、ご利用の際にはぜひご参照下さい。
Force.com REST API 入門
http://wiki.developerforce.com/index.php/JP:Getting_Started_with_the_Force.com_REST_API
Salesforce.comのOAuth 2.0を掘り下げてみよう
http://wiki.developerforce.com/index.php/JP:Digging_Deeper_into_OAuth_2.0_at_Salesforce.com
REST APIを利用することで、Rubyなどプログラミング言語やJavaScriptからForce.com のデータベースへ非常に簡単に接続できるようになります。
Herokuの様なオープンなPaaSや、iPhone&iPadなどのiOSデバイス、Android端末、またはnode.jsといった先進的テクノロジなど、様々な場所からForce.comデータベースへ接続してみましょう!!
Force.comのインテグレーションに関する記事
by Mitsuhiro Okamoto on 10月 29, 2009 at 11:08 午前
Force.com WebサービスAPIやHTTPコールアウト、EmailToApexなどのForce.comに搭載される各種インテグレーション機能をご紹介する記事「Integrating with the Force.com Platform」の日本語訳が公開されました。
Force.com プラットフォームの統合機能
http://wiki.developerforce.com/index.php/JP:Integrating_with_the_Force.com_Platform
CRMやForce.com上で構築されたアプリケーションを他のシステムと連携させる場合の参考になればと思います。
是非ご覧下さい!!

