今回は 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 も試してみました。表テーブルの画像を送信してみると、正確にセルのインデックスまで検知できていますが、各セル内のラベルと値は区別されず一つのテキストとして判定されてしまうようですね。