컬렉션에서 얼굴 삭제

DELETE

faces

Delete a face from collection

curl --request DELETE \
  --url https://face.argosidentity.com/faces \
  --header 'x-api-key: <api-key>'

{
  "message": "Face deleted successfully"
}

이 API 엔드포인트를 통해 특정 컬렉션에서 얼굴을 삭제할 수 있습니다. 이 기능은 얼굴 인식 데이터베이스를 관리하고 정리하는 데 유용합니다.

요청

헤더

x-api-key

string

인증 및 접근 제어에 사용되는 API 키입니다. 이 헤더 매개변수는 인증에 필요합니다.

쿼리 매개변수

collectionId

string

필수

얼굴이 포함된 컬렉션의 고유 식별자입니다.

faceId

string

필수

삭제할 얼굴의 고유 식별자입니다.

응답

성공 응답 (200)

message

string

얼굴 삭제 결과를 나타내는 성공 메시지

오류 응답

잘못된 요청 (400)

errorCode

number

문제 해결을 위한 특정 오류를 식별합니다:

6030: CollectionId가 필요합니다
6031: FaceId가 필요합니다
6032: 컬렉션 정보를 찾을 수 없습니다
6033: 이 컬렉션은 사용할 수 없습니다
6034: 얼굴 삭제 실패

message

string

오류에 대한 간략한 설명입니다. 자세한 내용은 오류 코드를 참조하세요.

금지됨 (403)

errorCode

number

문제 해결을 위한 특정 오류를 식별합니다:

6039: API 키가 필요합니다
6040: 액세스 거부: API 키를 사용할 수 없습니다

message

string

오류에 대한 간략한 설명입니다. 자세한 내용은 오류 코드를 참조하세요.

인증

x-api-key

string

header

필수

쿼리 매개변수

collectionId

string

필수

Unique identifier of the collection

faceId

string

필수

Unique identifier of the face to delete

응답

Face successfully deleted from collection

message

string

Success message

예시:

"Face deleted successfully"

컬렉션에서 얼굴 검색제출된 이미지를 사용하여 컬렉션 내에서 일치하는 얼굴을 검색

⌘I

​요청

​헤더

​쿼리 매개변수

​응답

​성공 응답 (200)

​오류 응답

​잘못된 요청 (400)

​금지됨 (403)

인증

쿼리 매개변수

응답

요청

헤더

쿼리 매개변수

응답

성공 응답 (200)

오류 응답

잘못된 요청 (400)

금지됨 (403)