Skip to main content
단건 조회는 목록 조회와 별도 endpoint입니다.구 엔드포인트에서 GET /v3/faceauth?authId=...로 조회하던 방식이 GET /v3/face-auth/{authId} path parameter 방식으로 바뀌었습니다. 기존 연동을 옮기려면 FaceAuth 공통 참조 — 구 API에서 옮기기를 확인하세요.
FaceAuth 제출 건 하나를 조회합니다. 생성 직후에도 색인 반영을 기다릴 필요 없이 authId로 바로 조회할 수 있습니다.

1. Base URL

GET/Face-auth/{authId}

2. 인증

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

3. 요청 예시

GET/Face-auth/{authId}

4. Path 파라미터

string
필수
FaceAuth submission의 키값입니다. POST 생성 응답 또는 목록 응답authId를 사용합니다.

5. 응답

result.json

5-1. 성공

단건 조회에 성공하면 200 OK와 함께 FaceAuthSubmission 객체가 돌아옵니다. 객체 하나가 그대로 최상위에 옵니다.
  • 목록 items[] 요소와 단건 응답은 같은 객체입니다. 같은 authId를 두 경로로 조회하면 같은 field 집합이 돌아옵니다.
  • 삭제된 submission은 deleteTime에 값을 담아 반환합니다.

5-2. 실패

단건 조회에 실패하면 HTTP 상태 코드와 함께 에러 객체가 돌아옵니다.
다른 FaceAuth 프로젝트의 submission도 존재하지 않는 authId와 동일하게 404를 반환합니다. 응답으로는 두 경우를 구분할 수 없습니다.

6. 오류 응답

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