POST
/v1/viewer-url/uploadFile Upload API
클라이언트가 CAD 파일을 직접 업로드하면 서버에 저장 후 Viewer에서 접근 가능한 Signed URL을 생성합니다. 파일 업로드는 `multipart/form-data` 형식을 사용합니다. 업로드된 파일은 서버 스토리지에 저장되며, Signed URL을 통해 Viewer에서 접근합니다.
Headers
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| x-client-id | string | 필수 | 클라이언트 ID |
| x-api-key | string | 필수 | API 키 |
| Content-Type | string | 필수 | Request Body |
Request Bodymultipart/form-data
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| file | binary | 필수 | 업로드할 CAD DWG 파일 (20MB 이하) |
| fileInfo | string (JSON) | 필수 | 파일 메타데이터 (JSON 문자열) |
| userId | string | 선택 | 사용자 ID |
| planCode | string | 선택 | 요금제 코드 |
fileInfoJSON 구조
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| id | string | 필수 | 파일 고유 ID |
| name | string | 필수 | 파일명 |
| 상태 | 설명 | 오류코드 | 메시지 | 응답 |
|---|---|---|---|---|
| 200 | 파일 업로드 성공 | - | - | |
| 400 | 잘못된 클라이언트 | VIEWER_URL_INVALID_CLIENT | Invalid client | |
| 400 | 인증 정보 누락 | VIEWER_URL_INVALID_API_KEY | Invalid client-id or api-key | |
| 400 | 유효성 검증 오류 | VIEWER_URL_VALIDATION_ERROR | fileInfo: name should not be empty... | |
| 400 | 잘못된 요금제 코드 | VIEWER_URL_CLIENT_PLAN_NOT_EXISTS | The webcad client plan not exists | |
| 413 | 파일 크기 초과 | VIEWER_URL_FILE_TOO_LARGE | File too large |