POST
/v1/viewer-url/urlFile URL API
클라이언트가 제공한 파일 URL을 기반으로 Viewer에서 접근 가능한 Signed URL을 생성합니다. 파일은 외부 서버에 호스팅되어 있어야 하며, 해당 URL로 파일을 다운로드할 수 있어야 합니다. 필요한 경우 URL 접근을 위한 커스텀 헤더를 함께 전달할 수 있습니다.
Headers
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| x-client-id | string | 필수 | 클라이언트 ID |
| x-api-key | string | 필수 | API 키 |
| Content-Type | string | 필수 | Request Body |
Request Bodyapplication/json
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| userId | string | 선택 | 사용자 ID |
| fileInfo | object | 필수 | 파일 메타데이터 (JSON 객체) |
| planCode | string | 선택 | 요금제 코드 |
fileInfoJSON
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| id | string | 필수 | 파일 고유 ID |
| name | string | 필수 | 파일명 |
| url | string | 필수 | 파일 다운로드 URL |
| urlHeaders | object | 선택 | URL 접근 시 필요한 헤더 |
| 상태 | 설명 | 오류코드 | 메시지 | 응답 |
|---|---|---|---|---|
| 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 |