메인 콘텐츠로 건너뛰기
GET
curl

개요

세션 일괄 삭제로 시작한 대량 세션 삭제 작업의 상태, 처리된 세션 수, 각 결과별 세션 수를 반환합니다. session_numbers로 선택하거나 delete_all을 사용한 일괄 삭제 요청이 20개를 초과하는 KYC 세션과 일치하면, 요청은 202와 PENDING 상태의 작업을 반환하고 세션은 백그라운드에서 삭제됩니다. status가 COMPLETED 또는 FAILED가 될 때까지 이 endpoint를 몇 초 간격으로 조회하세요. 작업이 삭제하는 각 세션은 세션 삭제와 정확히 같은 방식으로 삭제됩니다. 세션, 세션이 보유한 모든 인증 시도, 저장된 모든 파일이 삭제되며, 미디어 URL로 더 이상 접근할 수 없습니다. 삭제는 영구적이며 되돌릴 수 없습니다. 작업은 건수만 보고합니다. 삭제된 세션의 목록은 제공하지 않습니다.

작업 상태

delete_all 작업은 요청 이전에 생성된 세션만 삭제합니다. 작업이 실행되는 동안 시작된 세션은 삭제되지 않습니다.

결과 건수

deleted_child_verifications는 기업 확인(KYB)이 생성한 인증 중 함께 삭제된 인증의 수를 셉니다. 세션 일괄 삭제로 시작한 작업에서는 KYC 세션만 삭제하므로 항상 0입니다.

권한

애플리케이션의 활성 API 키라면 모두 이 endpoint를 호출할 수 있습니다. 작업은 이를 생성한 애플리케이션에만 보이며, 다른 job_id는 404를 반환합니다.

관련 문서

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

job_id
string<uuid>
필수

POST /v3/sessions/delete/의 202와 함께 반환된 job_id입니다.

응답

작업입니다.

백그라운드에서 실행 중인 대량 세션 삭제: 진행 상황과 결과별 건수이며, 삭제된 세션 목록은 포함되지 않습니다.

job_id
string<uuid>

이 id로 GET /v3/sessions/delete/{job_id}/를 폴링하십시오.

status
enum<string>

PENDING: 접수되었으며 아직 시작되지 않음. PROCESSING: 삭제 중이며 processed 및 outcomes가 업데이트되는 중임. COMPLETED: 선택한 모든 세션이 처리됨. FAILED: 작업이 조기 중단됨. error를 참조하십시오.

사용 가능한 옵션:
PENDING,
PROCESSING,
COMPLETED,
FAILED
total
integer

삭제 요청 시 선택된 세션입니다.

processed
integer

작업이 지금까지 처리를 완료한 세션입니다.

outcomes
object

각 결과로 종료된 세션 수입니다. 모든 키는 항상 존재합니다.

deleted_child_verifications
integer

삭제된 기업 인증에서 생성되어 함께 삭제된 인증 건수입니다. KYC 세션만 삭제하는 POST /v3/sessions/delete/로 시작된 작업의 경우 항상 0입니다.

error
string | null

status가 FAILED가 아닌 한 null이며, 이때 삭제가 중단된 이유가 표시됩니다. 작업이 도달하지 않은 세션은 그대로 유지되므로 요청을 다시 실행하여 삭제하십시오.

created_at
string<date-time>

삭제가 요청된 시점입니다.

completed_at
string<date-time> | null

작업이 완료된 시점입니다. 실행 중일 때는 null입니다.

마지막 수정일 2026년 11월 7일