> Agent-readable docs index: /llms.txt. Fetch only the needed Markdown pages first; use /docs.zip only for broad search after checking /docs-manifest.json or /docs.zip.sha256.

# 이미지

이미지 관련 API입니다.

업로드 URL 생성과 내원객 이미지 등록 기능을 제공합니다.

<details>
<summary>주요 개념</summary>
<dl>
<dt>presigned URL</dt>
<dd><strong>정의:</strong> 이미지 파일을 업로드할 수 있도록 발급되는 임시 업로드 URL입니다.<br /><strong>설명:</strong> KOS API로 파일을 직접 보내는 것이 아니라, 응답의 URL에 이미지 바이너리를 <code>PUT</code> 요청으로 업로드합니다. 발급된 URL은 5분 동안 유효합니다.</dd>
<dt>내원객 이미지</dt>
<dd><strong>정의:</strong> 내원객에게 연결해 관리하는 이미지 파일 정보입니다.<br /><strong>설명:</strong> 파일 업로드 후 파일 이름, 내원객 ID, 이미지 출처, 촬영 일시 등을 전달해 내원객 이미지로 등록합니다.</dd>
<dt>이미지 출처</dt>
<dd><strong>정의:</strong> 이미지가 어디에서 생성되었는지 구분하는 값입니다.<br /><strong>설명:</strong> 원내 촬영, 내원객 촬영, 동의서, 펜 차트처럼 이미지의 발생 맥락을 표시합니다.</dd>
<dt>촬영 장비 코드</dt>
<dd><strong>정의:</strong> 이미지를 촬영한 장비를 나타내는 코드입니다.<br /><strong>설명:</strong> 병원에서 관리하는 장비 코드와 연결해 이미지의 촬영 장비를 구분할 때 사용합니다.</dd>
<dt>이미지 분류 코드</dt>
<dd><strong>정의:</strong> 이미지를 업무 기준으로 분류하는 코드입니다.<br /><strong>설명:</strong> 경과 사진, 상담 자료처럼 병원에서 정의한 이미지 분류 체계에 맞춰 이미지를 정리할 때 사용합니다.</dd>
<dt>이미지 폴더 경로</dt>
<dd><strong>정의:</strong> 이미지가 속한 폴더 위치를 나타내는 경로입니다.<br /><strong>설명:</strong> 슬래시(<code>/</code>)로 하위 폴더를 구분해 내원객 이미지를 폴더 구조로 관리할 수 있습니다.</dd>
</dl>
</details>


## 엔드포인트

- [이미지 업로드 URL 발급](/docs/openapi/generate-uploading-image-url.md): `POST /image/open/v1/commands/generate-uploading-url`
- [내원객 이미지 등록](/docs/openapi/register-visitor-images.md): `POST /image/open/v1/commands/register-visitor-images`