이 작업은 되돌릴 수 없습니다. 삭제된 레코드는 복구할 수 없습니다.
엔드포인트
기본 URL
인증
요청 헤더에 API 키를 포함하세요:인증을 위한 API 키
경로 매개변수
삭제할 레코드가 포함된 워크리스트의 ID
요청 본문
삭제 요청을 하는 관리자의 이메일 주소 (프로젝트의 관리자 목록에 등록되어 있어야 함)
삭제할 레코드 ID 배열 (최대 1-25개 레코드)
요청 예시
응답
성공 응답
응답 필드
삭제 작업을 확인하는 성공 메시지
오류 응답
오류 코드
오류 코드 | HTTP 상태 | 설명 |
---|---|---|
invalid_payload | 400 | 요청 페이로드 누락 또는 형식 오류 |
invalid_admin | 400 | 잘못된 관리자 계정 또는 프로젝트에 등록되지 않은 관리자 |
invalid_record | 400 | 하나 이상의 레코드 ID가 존재하지 않음 |
invalide_worklist | 400 | 잘못된 워크리스트 ID |
invalid_project | 400 | 프로젝트 ID 누락 또는 잘못된 API 키 |
중요 사항
삭제 제한사항:
- 요청당 최대 25개 레코드만 삭제 가능
- 지정된 워크리스트 내의 레코드만 삭제 가능
- 삭제는 영구적이며 되돌릴 수 없음
- 진행하기 전에 올바른 레코드 ID가 있는지 확인하세요
모범 사례:
- 삭제 시도 전에 레코드 ID가 존재하는지 확인
- 효율성 향상을 위해 여러 삭제에 배치 작업 사용
- 삭제 전 중요한 레코드의 백업 유지
- 부분 실패에 대한 응답 모니터링
배치 처리:
- 시스템은 단일 요청에서 모든 레코드 ID를 처리합니다
- 일부 레코드가 삭제에 실패하면 응답에 상세한 오류 정보가 포함됩니다
- 부분 실패가 가능합니다 - 일부 레코드는 삭제되고 다른 레코드는 실패할 수 있습니다
속도 제한
이 엔드포인트는 표준 속도 제한 정책을 따릅니다. 각 요청은 동시에 최대 25개의 레코드 삭제를 처리할 수 있습니다.