# API로 연결 {/* #connect-via-api */}

공개 API로 자체 앱에서 캡처 카탈로그를 나열하고 상세 정보를 읽으세요. 생성형 클라이언트에는 [gRPC](/docs/ko/api/grpc)(브라우저용 gRPC-Web 포함), HTTP의 JSON에는 [REST](/docs/ko/api/rest)를 선택하세요.

## 시작하기 전 {/* #before-you-start */}

1. [Reconstruct Platform](https://reconstruct.dev/platform/)에 로그인하고 **Settings → API tokens**를 열어 **Platform API** 범위(`api`)의 토큰을 만드세요. 비밀은 한 번만 표시되므로 나타날 때 복사하세요.
2. 서버 측 클라이언트를 실행하는 환경에 `CR_RECONSTRUCT_API_TOKEN`을 설정하세요. MCP 범위만 있는 토큰은 PlatformService를 인증하지 못합니다.
3. REST에는 `https://reconstruct.dev/api/v1/platform`, gRPC-Web에는 `https://reconstruct.dev`을 사용하세요. 네이티브 gRPC 클라이언트는 TLS로 `reconstruct.dev:443`에 연결합니다.

모든 요청에서 토큰을 `Authorization: Bearer <token>`으로 전달하세요.

## API 방식 선택 {/* #choose-an-api-style */}

| 방식 | 공개 엔드포인트 | 가이드 |
|---|---|---|
| gRPC | 네이티브 gRPC는 `reconstruct.dev:443`, gRPC-Web은 `https://reconstruct.dev` | [개요 및 클라이언트 생성](/docs/ko/api/grpc) |
| REST | `https://reconstruct.dev/api/v1/platform` | [엔드포인트 및 예시](/docs/ko/api/rest) |

두 방식 모두 카탈로그 목록, 버전 상세 정보, 인사이트, 저장 파일과 내보내기 및 호출자의 요청을 제공합니다. 반환된 `nextPageToken`(REST) 또는 `next_page_token`(gRPC)으로 다음 페이지를 요청하세요. 카탈로그 ID는 목록 응답에서 가져오세요.

`CreateRequest`, `ListRequests`, `GetRequest`로 제품을 제출하고 본인의 요청을 추적하세요. 요청은 캡처 전에 검토됩니다. 응답은 결정, 안전 상태 및 캡처 진행 상황을 보여줍니다.