API Reference
컬렉션의 얼굴 목록 가져오기
특정 컬렉션 내에 포함된 모든 얼굴의 목록을 검색
GET
Get list of faces in collection
이 API 엔드포인트를 통해 특정 컬렉션 내에 포함된 모든 얼굴의 목록을 검색할 수 있습니다. 페이지네이션 및 검색 기능을 사용하여 대용량 얼굴 데이터 컬렉션을 효율적으로 관리할 수 있습니다.
요청
헤더
쿼리 매개변수
응답
성공 응답 (200)
다음을 포함하는 얼굴 객체의 배열:collection_id: 얼굴 컬렉션의 고유 식별자face_id: 컬렉션 내 얼굴의 고유 식별자user_name: 얼굴과 관련된 사용자의 이름create_time: 얼굴이 추가된 타임스탬프meta_face_id: 얼굴의 메타데이터 식별자
오류 응답
잘못된 요청 (400)
문제 해결을 위한 특정 오류를 식별합니다:
- 6024: CollectionId가 필요합니다
- 6025: Term 문자열이 5자 미만입니다
- 6026: Page가 누락되었습니다
- 6027: 컬렉션 정보가 존재하지 않습니다
- 6028: 이 컬렉션은 사용할 수 없습니다
- 6029: 얼굴 목록 가져오기 실패
금지됨 (403)
관련 문서
Face ID 개요
얼굴 인식 및 신원 인증을 위한 Face ID API에 대해 알아보세요
Face ID: 작동 방식
Face ID 워크플로우 및 통합 프로세스 이해
Face ID 모범 사례
애플리케이션에서 Face ID를 구현하기 위한 모범 사례