メインコンテンツへスキップ
検索を使うと、エンドポイントごとに個別に問い合わせることなく、組織内のリソースを素早く見つけられます。1 つのクエリで、一致するプロジェクト、スタディ、シミュレーション、モデル、パラメータ化モデル、最適化、最適化テンプレート、実験テンプレート、パイプライン、セル仕様、および材料を返します。
検索は現在 REST API 経由でのみ利用できます。Ionworks Studio 内の検索バーは計画中ですが、まだリリースされていません。

検索可能な対象

リソース種別マッチする内容の例
プロジェクトプロジェクト名と説明
スタディアクセス可能なプロジェクト内のスタディ名
シミュレーションシミュレーション名とメタデータ
モデルモデル名と説明
パラメータ化モデルパラメータ化モデル名
最適化最適化実行名
最適化テンプレート組み込み・カスタムのテンプレート名
実験テンプレート組み込み・カスタムのプロトコルテンプレート
パイプラインパイプライン名と説明
セル仕様セル名、化学、識別子
材料負極、正極、電解液の材料
検索は各リソース種別の名前、説明、その他の識別フィールドに対してマッチングを行います。結果は現在の組織にスコープされ、プロジェクトレベルの権限を尊重します。アクセスできるリソースのみが表示されます。

API 経由で検索を使用する

検索は /search エンドポイントで利用できます。完全なリクエスト/レスポンススキーマについてはAPI リファレンスを参照してください。 典型的なリクエストはクエリ文字列を指定し、リソース種別ごとにグループ化されたマッチを返します:
curl -X GET "https://api.ionworks.com/search?q=NMC622" \
  -H "Authorization: Bearer $IONWORKS_API_KEY"
結果は API キーがアクセス可能なリソースにフィルタリングされます。
検索は、部分的な名前(例: セル化学、顧客名、プロトコルキーワード)は覚えているが、どのプロジェクトやスタディに含まれているかわからない場合に便利です。
検索はサーバー上で Postgres の全文インデックスを使用するため、組織にリソースが多く蓄積されてもクエリは高速に返されます。インデックスは自動的に維持されるため、設定は不要です。