GET/Face-auth/{authId}/Image

이미지를 본문으로 직접 반환하지 않고 302 Found로 redirect합니다.구 엔드포인트 GET /v3/faceauth/image는 JPEG 바이너리를 본문에 담아 반환했습니다. 신 엔드포인트는 다운로드 URL이 담긴 Location header를 반환하므로 HTTP client가 redirect를 따라가도록 설정해야 합니다. 기존 연동을 옮기려면 FaceAuth 공통 참조 — 구 API에서 옮기기를 확인하세요.

FaceAuth 제출의 대상 얼굴 이미지를 다운로드합니다.

1. Base URL

GET https://rest-api.argosidentity.com/v3/face-auth/{authId}/image

2. 인증

x-api-key header에 FaceAuth 프로젝트 API key를 포함해야 합니다.

x-api-key

x-api-key: {yourAPIKey}

3. 요청 예시

curl은 --location 옵션으로 redirect를 따라가야 합니다.

curl

curl --location "https://rest-api.argosidentity.com/v3/face-auth/{authId}/image" \
  -H "x-api-key: {yourAPIKey}" \
  --output face-image.jpg

python

import requests

# requests는 기본적으로 redirect를 따라갑니다.
resp = requests.get(
    "https://rest-api.argosidentity.com/v3/face-auth/{authId}/image",
    headers={"x-api-key": "{yourAPIKey}"},
)
with open("face-image.jpg", "wb") as f:
    f.write(resp.content)

4. Path 파라미터

string

필수

다운로드할 FaceAuth submission의 키값입니다.

5. 응답

5-1. 성공

이 endpoint는 JSON 본문이 아니라 redirect로 응답합니다. 성공하면 302 Found와 아래 header가 돌아오며 본문은 비어 있습니다.

result.http

HTTP/1.1 302 Found
Location: https://{signedDownloadUrl}

string

서명이 포함된 다운로드 URL입니다. 값을 해석하거나 수정하지 말고 그대로 따라가세요.

redirect를 따라가면 200 OK와 함께 얼굴 이미지 원본 데이터가 반환됩니다.

응답의 Content-Type으로 이미지 형식을 판별하지 마세요.Content-Type은 저장 시점의 값이라 jpg 같은 비표준 값이 올 수 있습니다. 이미지 형식은 파일 내용(magic number) 또는 저장 시 알고 있던 형식으로 판별하세요.

성공 응답의 본문은 비어 있습니다. 302를 JSON으로 파싱하지 마세요.
다운로드 URL은 5분 후 만료됩니다. 만료됐으면 이 API를 다시 호출해 새로 받으세요.

5-2. 실패

이미지 다운로드에 실패하면 HTTP 상태 코드와 함께 에러 객체가 돌아옵니다.

6. 접근·삭제 정책

API key의 FaceAuth 프로젝트와 submission의 project가 다르면, 존재하지 않는 authId와 동일하게 404를 반환합니다.
이미 삭제된 submission, deleteTime이 있는 submission, 원본 image reference가 없는 submission은 항상 404를 반환합니다.
DELETE 완료 후에는 이 API로 이미지를 다시 다운로드할 수 없습니다.

7. 오류 응답

아르고스 애플리케이션이 반환하는 오류는 { code, message } 형식입니다. 인증 계층에서 차단된 401과 일부 403은 이 형식을 따르지 않습니다. FaceAuth 공통 참조 — 인증 계층 오류를 참고하세요.

HTTP status	code	발생 조건
`400`	`REQUEST_INVALID`	`authId` path parameter가 유효하지 않은 경우
`403`	`AUTH_FORBIDDEN`	API key는 유효하지만 FaceAuth 프로젝트에 연결되지 않은 경우
`404`	`FACEAUTH_SUBMISSION_NOT_FOUND`	제출이 없거나 다른 프로젝트에 속했거나 삭제됐거나 이미지가 남아 있지 않은 경우
`503`	`UPSTREAM_UNAVAILABLE`	이미지 조회에 필요한 내부 서비스를 일시적으로 사용할 수 없는 경우. 잠시 후 동일 요청을 재시도합니다
`500`	`INTERNAL_UNEXPECTED`	예상하지 못한 서버 오류

​1. Base URL

​2. 인증

​3. 요청 예시

​4. Path 파라미터

​5. 응답

​5-1. 성공

​5-2. 실패

​6. 접근·삭제 정책

​7. 오류 응답

1. Base URL

2. 인증

3. 요청 예시

4. Path 파라미터

5. 응답

5-1. 성공

5-2. 실패

6. 접근·삭제 정책

7. 오류 응답