> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET/Faceauth/Image

> FaceAuth를 통해 제출한 셀피 이미지를 다운받을 수 있는 API로, authId를 활용하여 필요한 제출건의 이미지를 효과적으로 조회할 수 있습니다.

## 1. Base URL

```text GET/FaceAuth/Image theme={null}
  https://rest-api.argosidentity.com/v3/faceauth/image
```

## 2. 인증

x-api-key 헤더에 API 키를 포함시켜야 합니다:

```text x-api-key theme={null}
  x-api-key: {yourAPIKey}
```

## 3. 요청 예시

```curl GET/FaceAuth theme={null}
  curl --location "https://rest-api.argosidentity.com/v3/faceauth/image?authId={yourAuthId}" \
  --header 'x-api-key: {yourAPIKey}'
```

## 4. 요청 파라미터

<ResponseField name="authId" type="string" required>
  이미지를 다운 받을 authId
</ResponseField>

## 5. 응답

base64 인코딩된 이미지를 반환합니다.

### 5-1.Success Response

```json example.png theme={null}
  /9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BST0ZJTEUAAQEAAAHIAAAAAAQwAABtbnRyUkdCIFhZ...
```

### 5-2. 에러 코드

오류가 발생하면 400 상태 코드와 함께 응답 본문에 세부 정보가 포함됩니다:

```json error.json theme={null}
{
  traceId: '0199cb93-bdf1-77ef-8cd4-3d38dec61830',
  errorCode: 'NOT_FOUND',
  message: 'faceAuth_project not found'
}
```

| 에러 코드                        | 설명                                                                        |
| ---------------------------- | ------------------------------------------------------------------------- |
| `faceAuth_project not found` | 제출한 API-Key에 해당하는 유효한 프로젝트가 없을 경우 발생하는 오류입니다.입력한 API-Key가 올바른지 다시 확인해주세요. |
| `authId is required`         | 요청 파라미터에 authId가 없습니다.                                                    |