# API Skill Web アプリ

[English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)

## 起動

```bash
npm install
npm run dev
```

ターミナルに表示される Vite URL を開きます。

## インポート元

Web アプリは 4 種類のインポート方法に対応しています。

- 直接 OpenAPI/Swagger JSON または YAML URL。
- Swagger UI、Knife4j、Redoc ページのクロール。
- ローカル JSON/YAML ファイルのアップロード。
- OpenAPI/Swagger ドキュメントを返す curl コマンド。
- 上流ドキュメントがまだない場合の空白ドキュメント作成。

インポートされたドキュメントは `cache/versions/` に書き込まれ、`cache/latest-import.json` が現在の最新バージョンを指します。

## ゼロからドキュメントを作成

New Document タブで、タイトル、バージョン、任意の説明を入力して空白の OpenAPI 3.0 ドキュメントを作成できます。新しいドキュメントはすぐにアクティブなキャッシュバージョンになります。その後、Add/Edit/Delete API 操作を使って、外部ドキュメントを先にインポートせずに AI アシスタントや開発者が API 契約を段階的に作成できます。

## API の閲覧と確認

検索コントロールを使って、keyword、tag、method、リクエストボディの有無でエンドポイントをフィルタできます。エンドポイントをタブで開くと、次の情報を確認できます。

- リクエストパラメータ。
- リクエストボディフィールド。
- レスポンスフィールド。
- AI 向け Markdown コンテキスト。
- Raw OpenAPI JSON。

## バージョンと手動 API の管理

バージョン管理機能でキャッシュ済みバージョンを切り替えたり削除したりできます。Add/Edit/Delete API 操作は、上流 OpenAPI ドキュメントが不完全な場合、一時的なローカル契約が必要な場合、またはドキュメント全体をゼロから作成する場合に手動操作を管理するために使います。

手動操作はインポート済みドキュメントと同じバージョンキャッシュに保存されるため、CLI と MCP サーバーからすぐに照会できます。