콘텐츠로 이동

첨부 파일 다운로드


GET /api/v1/attachment/{attachment_uuid}/download

개요

첨부 파일 식별자로 현재 워크스페이스의 원본 파일을 다운로드합니다. 성공 응답에는 파일 바이너리 데이터가 포함됩니다.

호출 전 및 사용 단계

  1. 첨부 파일 업로드 성공 응답의 content.attachmentUuid에서 값을 가져옵니다.
  2. 읽기 권한이 있는 워크스페이스 API Key를 사용하고, 첨부 파일 식별자를 요청 경로에 넣습니다.
  3. 먼저 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의 워크스페이스를 확인하고, 필요하면 다시 업로드하세요.

문서 평가

이 페이지가 도움이 되었나요?