# 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 앱은 네 가지 가져오기 방식을 지원합니다.

- 직접 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 컨텍스트.
- 원본 OpenAPI JSON.

## 버전 및 수동 API 관리

버전 관리자로 캐시된 버전을 전환하거나 삭제할 수 있습니다. Add/Edit/Delete API 작업은 상위 OpenAPI 문서가 불완전하거나, 임시 로컬 계약이 필요하거나, 전체 문서를 처음부터 작성해야 할 때 수동 작업을 유지하는 데 사용합니다.

수동 작업은 가져온 문서와 같은 버전 캐시에 저장되므로 CLI와 MCP 서버에서 즉시 조회할 수 있습니다.