> For the complete documentation index, see [llms.txt](https://developer.eagle.cool/web-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.eagle.cool/web-api/ja-jp/changelog.md).

# 変更履歴

Eagle Web API V2 の変更履歴です。すべての重要な変更を記録しています。

{% hint style="info" %}
V1 API の変更履歴をお探しですか？[旧バージョン V1 API ドキュメント](https://api.eagle.cool/)をご覧ください。
{% endhint %}

***

## Smart Folder API -- Eagle 4.0 Build 22

{% hint style="danger" %}
**この機能はまだリリースされていません**：この機能には Eagle 4.0 Build 22 以降が必要です。リリース日程については Eagle 公式サイトをご確認ください。
{% endhint %}

スマートフォルダの完全な CRUD エンドポイントとルールクエリ機能を追加：

* `GET /api/v2/smartFolder/get` -- すべてのスマートフォルダを一覧表示
* `POST /api/v2/smartFolder/create` -- スマートフォルダを作成
* `POST /api/v2/smartFolder/update` -- スマートフォルダを更新
* `POST /api/v2/smartFolder/remove` -- スマートフォルダを削除
* `GET /api/v2/smartFolder/getItems` -- 条件に一致するアイテムを取得
* `GET /api/v2/smartFolder/getRules` -- 利用可能なルールスキーマを取得

### Item API 強化

* `POST /api/v2/item/get` に `smartFolders` パラメータを追加、他のフィルタと組み合わせて使用可能

***

## Comment API -- Eagle 4.0 Build 22

{% hint style="danger" %}
**この機能はまだリリースされていません**：この機能には Eagle 4.0 Build 22 以降が必要です。リリース日程については Eagle 公式サイトをご確認ください。
{% endhint %}

画像の矩形アノテーションと動画のタイムラインノートを管理するための新しいコメント CRUD エンドポイント：

* `GET /api/v2/item/getComments` -- アイテムのすべてのコメントを取得
* `POST /api/v2/item/addComment` -- 画像矩形コメントまたは動画タイムスタンプコメントを追加
* `POST /api/v2/item/updateComment` -- 既存のコメントを更新
* `POST /api/v2/item/removeComment` -- コメントを削除

***

## V2 API -- 初回リリース

V2 API（`/api/v2/...`）は、Eagle の Plugin API の機能に基づいて構築された V1 API の包括的な後継版です。主な機能：

### 新機能（V1 との比較）

* **全文検索** -- `POST /api/v2/item/query` で高度なクエリ構文（AND、OR、NOT、フレーズ）に対応
* **AI セマンティック検索** -- テキスト説明による検索（`searchByText`）、画像の類似性による検索（`searchByBase64`、`searchByItemId`）
* **タグ管理** -- タグの作成、名前変更、統合、タググループの管理
* **フォルダ管理** -- フォルダの作成、移動、名前変更、整理
* **自動ページネーション** -- すべてのリストエンドポイントがデフォルトでページネーション結果を返却（`offset` / `limit`）
* **フィールド選択** -- アイテムリストで `fields` パラメータを使用して必要なデータのみを返却

### エンドポイント

| セクション     | エンドポイント                                                                                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Item      | `get`, `query`, `countAll`, `add`, `save`, `open`, `select`, `setCustomThumbnail`, `refreshThumbnail`, `getComments`, `addComment`, `updateComment`, `removeComment` |
| Folder    | `get`, `create`, `open`, `save`                                                                                                                                      |
| Tag       | `get`, `getRecentTags`, `getStarredTags`, `save`, `merge`                                                                                                            |
| Tag Group | `get`, `create`, `save`, `remove`, `addTags`, `removeTags`                                                                                                           |
| Library   | `info`                                                                                                                                                               |
| App       | `info`                                                                                                                                                               |
| AI Search | `isInstalled`, `isReady`, `isStarting`, `isSyncing`, `getSyncStatus`, `checkServiceHealth`, `searchByText`, `searchByBase64`, `searchByItemId`                       |

### ページネーション

すべてのリストエンドポイントは自動ページネーションを使用します：

* デフォルトリミット：`50`
* 最大リミット：`1000`
* レスポンスに `total`、`offset`、`limit` のメタデータを含む