API로 연결
공개 API로 자체 앱에서 캡처 카탈로그를 나열하고 상세 정보를 읽으세요. 생성형 클라이언트에는 gRPC(브라우저용 gRPC-Web 포함), HTTP의 JSON에는 REST를 선택하세요.
시작하기 전
- Reconstruct Platform에 로그인하고 Settings → API tokens를 열어 Platform API 범위(
api)의 토큰을 만드세요. 비밀은 한 번만 표시되므로 나타날 때 복사하세요. - 서버 측 클라이언트를 실행하는 환경에
CR_RECONSTRUCT_API_TOKEN을 설정하세요. MCP 범위만 있는 토큰은 PlatformService를 인증하지 못합니다. - REST에는
https://reconstruct.dev/api/v1/platform, gRPC-Web에는https://reconstruct.dev을 사용하세요. 네이티브 gRPC 클라이언트는 TLS로reconstruct.dev:443에 연결합니다.
모든 요청에서 토큰을 Authorization: Bearer <token>으로 전달하세요.
API 방식 선택
| 방식 | 공개 엔드포인트 | 가이드 |
|---|---|---|
| gRPC | 네이티브 gRPC는 reconstruct.dev:443, gRPC-Web은 https://reconstruct.dev | 개요 및 클라이언트 생성 |
| REST | https://reconstruct.dev/api/v1/platform | 엔드포인트 및 예시 |
두 방식 모두 카탈로그 목록, 버전 상세 정보, 인사이트, 저장 파일과 내보내기 및 호출자의 요청을 제공합니다. 반환된 nextPageToken(REST) 또는 next_page_token(gRPC)으로 다음 페이지를 요청하세요. 카탈로그 ID는 목록 응답에서 가져오세요.
CreateRequest, ListRequests, GetRequest로 제품을 제출하고 본인의 요청을 추적하세요. 요청은 캡처 전에 검토됩니다. 응답은 결정, 안전 상태 및 캡처 진행 상황을 보여줍니다.