메인 콘텐츠로 건너뛰기
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"