POST
/
faces
Add a new face to a collection
curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/faces \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "collectionId": "col_123456789",
  "userName": "John Doe",
  "faceImage": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."
}'
{
  "message": "Face added successfully",
  "faceId": "face_123456789",
  "metaFaceId": "meta_123456789",
  "option": {}
}
“컬렉션에 새 얼굴 추가” 섹션을 통해 사용자는 특정 컬렉션 내에 새로운 얼굴 이미지를 쉽게 업로드하고 저장할 수 있습니다. 이 기능을 활용하여 사용자는 기존 데이터베이스에 새로운 얼굴을 추가하여 얼굴 인식 데이터를 효율적으로 관리하고 구성할 수 있습니다. 이 섹션은 얼굴 인식 애플리케이션에서 정확도와 효율성을 향상시키기 위해 추가 얼굴 데이터로 컬렉션을 확장하는 프로세스를 간소화합니다.

​
요청

​
헤더

​
x-api-key
string
required
인증 및 접근 제어에 사용되는 API 키입니다. 이 헤더 매개변수는 컬렉션에 새 얼굴을 추가하기 위한 인증에 필요합니다.

​
본문 매개변수

​
collectionId
string
required
얼굴이 추가될 컬렉션의 고유 식별자입니다.
​
userName
string
required
컬렉션에 추가되는 얼굴과 관련된 이름입니다.
​
faceImage
string
required
얼굴 이미지의 Base64 인코딩된 문자열 표현입니다.

​
응답

​
성공 응답 (200)

​
message
string
얼굴 제출 결과를 나타내는 성공 또는 오류 메시지
​
faceId
string
얼굴 제출에 대한 고유 식별자입니다.
​
metaFaceId
string
얼굴 제출의 메타데이터에 해당하는 고유 식별자입니다.
​
option
object
얼굴 제출을 위한 추가 옵션 및 메타데이터입니다.

​
오류 응답

​
잘못된 요청 (400)

​
errorCode
number
문제 해결을 위한 특정 오류를 식별합니다:
  • 6010: CollectionId가 필요합니다
  • 6011: WorkspaceId가 필요합니다
  • 6012: 얼굴 추가 실패
  • 6013: 컬렉션 정보를 찾을 수 없습니다
  • 6014: 이 컬렉션은 사용할 수 없습니다
  • 6015: 얼굴의 생체 검증 실패
  • 6016: 이미지 크기가 너무 큽니다
  • 6017: 지원되지 않는 이미지 형식
​
message
string
오류에 대한 간략한 설명입니다. 자세한 내용은 오류 코드를 참조하세요.

​
금지됨 (403)

​
errorCode
number
문제 해결을 위한 특정 오류를 식별합니다.
​
message
string
오류에 대한 간략한 설명입니다:
  • API 키가 필요합니다
  • 액세스 거부: API 키를 사용할 수 없습니다

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
collectionId
string
required

Unique identifier of the collection where the face will be added

Example:

"col_123456789"

​
userName
string
required

Name associated with the face being added to the collection

Example:

"John Doe"

​
faceImage
string
required

Base64-encoded string representation of the face image

Example:

"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."

Response

Face successfully added to collection

​
message
string

Success message

Example:

"Face added successfully"

​
faceId
string

Unique identifier for the face submission

Example:

"face_123456789"

​
metaFaceId
string

Unique identifier corresponding to the metadata of the face submission

Example:

"meta_123456789"

​
option
object

Additional options and metadata for the face submission