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 상태 코드와 함께 에러 객체가 돌아옵니다.6. 오류 응답
아르고스 애플리케이션이 반환하는 오류는{ code, message } 형식입니다. 인증 계층에서 차단된 401과 일부 403은 이 형식을 따르지 않습니다. FaceAuth 공통 참조 — 인증 계층 오류를 참고하세요.