첨부 파일 다운로드¶
GET /api/v1/attachment/{attachment_uuid}/download
개요¶
첨부 파일 식별자로 현재 워크스페이스의 원본 파일을 다운로드합니다. 성공 응답에는 파일 바이너리 데이터가 포함됩니다.
호출 전 및 사용 단계¶
- 첨부 파일 업로드 성공 응답의 content.attachmentUuid에서 값을 가져옵니다.
- 읽기 권한이 있는 워크스페이스 API Key를 사용하고, 첨부 파일 식별자를 요청 경로에 넣습니다.
- 먼저 HTTP 상태를 확인합니다. 200이면 응답을 파일로 저장하며, 원본 파일 이름은 Content-Disposition에서 확인할 수 있습니다. 명령이 실패하면 먼저 상태를 확인하고, 오류 JSON을 읽어야 할 경우 curl -i로 동일한 첨부 파일 경로를 조회할 수 있습니다.
경로 매개변수¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| attachment_uuid | string | Y | 첨부 파일 ID null 허용: False 예시: att_00000000000000000000000000000000가져오기 또는 입력 방법: 첨부 파일 업로드 성공 응답의 content.attachmentUuid에서 값을 가져옵니다. |
요청 헤더¶
| 매개변수 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | AK 식별자, AK uuid 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 이 API 권한이 있는 Key를 가져옵니다. |
요청 예시¶
curl --fail --dump-header response-headers.txt --output downloaded.bin 'https://openapi.guance.com/api/v1/attachment/att_00000000000000000000000000000000/download' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/octet-stream; charset=UTF-8. 본문은 원본 파일 바이트입니다.
| 응답 헤더 | 유형 | 설명 |
|---|---|---|
| Content-Type | string | application/octet-stream; charset=UTF-8. |
| Content-Disposition | string | attachment; filename=<URL 인코딩된 원본 파일 이름>. |
HTTP/1.1 200 OK
Content-Type: application/octet-stream; charset=UTF-8
Content-Disposition: attachment; filename=report.pdf
<파일 바이트>
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.NotFoundAttachment | 첨부 파일이 없거나 삭제되었거나 현재 워크스페이스에 일치하는 레코드가 없음 | 해당 첨부 파일 리소스 정보를 찾을 수 없습니다. | 첨부 파일 식별자와 API Key의 워크스페이스를 확인하고, 필요하면 다시 업로드하세요. |