New Omni documentation is now available — policy-driven document verification and API reference. Explore Omni → · Custom Theme for KYC liveform: Learn more →
Face ID
Face Liveness
New Omni documentation is now available — policy-driven document verification and API reference. Explore Omni → · Custom Theme for KYC liveform: Learn more →
API Reference
컬렉션에서 얼굴 검색
제출된 이미지를 사용하여 컬렉션 내에서 일치하는 얼굴을 검색
POST
/
search
Search face in collection
curl --request POST \
--url https://face.argosidentity.com/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"collectionId": "col_123456789",
"requestName": "John Doe",
"faceImage": "9j/4AAQSkZJRgABAQAAAQ..."
}
'{
"message": "Search completed successfully",
"result": [
{
"face_id": "<string>",
"user_name": "<string>",
"similarity_score": 123
}
]
}이 API 엔드포인트를 통해 제출된 이미지를 사용하여 컬렉션 내에서 일치하는 얼굴을 검색할 수 있습니다. 이 기능은 얼굴 인식 및 신원 확인 애플리케이션에서 매우 유용합니다.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.
요청
헤더
인증 및 접근 제어에 사용되는 API 키입니다. 이 헤더 매개변수는 인증에 필요합니다.
본문 매개변수
검색할 컬렉션의 고유 식별자입니다.
얼굴 이미지와 일치하는 이름
검색할 얼굴 이미지의 Base64 인코딩된 문자열 표현입니다.
응답
성공 응답 (200)
얼굴 검색 결과를 나타내는 성공 메시지
일치하는 얼굴 객체의 배열:face_id: 일치하는 얼굴의 고유 식별자user_name: 일치하는 얼굴과 관련된 사용자의 이름similarity_score: 검색된 얼굴과 일치하는 얼굴 간의 유사성 점수
오류 응답
잘못된 요청 (400)
문제 해결을 위한 특정 오류를 식별합니다:
- 6035: CollectionId가 필요합니다
- 6036: FaceImage가 필요합니다
- 6037: 컬렉션 정보를 찾을 수 없습니다
- 6038: 얼굴 검색 실패
오류에 대한 간략한 설명입니다. 자세한 내용은 오류 코드를 참조하세요.
금지됨 (403)
문제 해결을 위한 특정 오류를 식별합니다:
- 6039: API 키가 필요합니다
- 6040: 액세스 거부: API 키를 사용할 수 없습니다
오류에 대한 간략한 설명입니다. 자세한 내용은 오류 코드를 참조하세요.
인증
본문
application/json
이 페이지가 도움이 되었나요?
⌘I
Search face in collection
curl --request POST \
--url https://face.argosidentity.com/search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"collectionId": "col_123456789",
"requestName": "John Doe",
"faceImage": "9j/4AAQSkZJRgABAQAAAQ..."
}
'{
"message": "Search completed successfully",
"result": [
{
"face_id": "<string>",
"user_name": "<string>",
"similarity_score": 123
}
]
}