今回は Salesforce から提供されている Einstein Platform Services の Open API 3.0 Spec を使ってみます。Rest リソースの Open API Spec が提供されていると、対応しているツールからであれば簡単にリクエストが投げられるようになるのでありがたいですね。
Salesforce は今後、 Salesforce の Rest リソースに対し Open API ３.0 Spec を提供していくと発表しましたが、システム連携もノーコード化されていく日が来るんでしょうね。来る日に備えつつ、とりあえず OAS を Postman に取り込んでリクエストを投げてみるところまでやってみます。
Einstein Platform Services の OAuth トークンを取得する
Rest API 経由で Einstein Platform Services の Rest API を呼び出すには、 OAuth トークンを必要になります。今回は Postman から投げるリクエストのヘッダーに追加できればいいので、 Einstein Platform Services のページで生成します。
そのためには、まず Signup ページ から Einstein Platform Services にサインアップします。事前に検証用の DE 環境を取得しておき、そのクレデンシャルでサインアップしましょう。
サインアップすると Private Key が発行されるのでメモしておきます。
次に Generate an OAuth Token ページを開き、サインアップしたユーザーの E メールアドレスと Private Key を貼り付けて、 GET TOKEN します。トークンの Expiration in minutes は 60 分くらいにしておくといろいろ実験できる時間が持てると思います。
発行された Token は Einstein Platform Services へのリクエストで利用するので、コピーしておきましょう。
Postman で Open API 3.0 Spec を読み込む
Einstein Platform Services の OAS は MetaMind のリポジトリで公開されているので、 vision-language-api-openapi-2.0.1.yaml の RAW ファイル をローカル環境にダウンロードしておきます。
デスクトップ版の Postman を開き、 サイドバーの APIs タブ > Create an API で、必要な項目を入力した後、ダウンロードした OAS を読み込み Create API します。
API が作成できたら、 Generate Collection します。 ここでは Test the API を選択しておきます。
Collections タブを開くと、Einstein Platform Services のエンドポイントがリストされていますが、最後に baseUrl というコレクション変数を書き換える必要があります。 今作成した Einstein Platform Services API Collection を Edit すると編集モーダルが開くので Variables タブから baseUrl の値を https://api.einstein.ai に書き換えておきましょう。これで準備が完了です。
Postman からリクエストを送信
API の利用状況を確認
試しに Get API Usage のエンドポイントにリクエストを送信してみます。上で取得した OAuth トークンを Authorization タブから入力して Send してみると、現在の API 利用状況が返ってきました。サクッと API の動きを確認できるのは良いですね。
画像内のテキストを検出
ちなみに Detect Text で OCR も試してみました。表テーブルの画像を送信してみると、正確にセルのインデックスまで検知できていますが、各セル内のラベルと値は区別されず一つのテキストとして判定されてしまうようですね。
