메인 콘텐츠로 건너뛰기
POST
Python
Didit의 비동기 Reports API는 내보내기를 다시 실행하거나 선택한 실패한 인증 항목을 재시도 대기열에 추가합니다. 새 재시도 요청은 201을 반환하고, 실패 항목 선택 내용이 동일하면 기존 보고서를 200으로 반환합니다.
선택적 재시도에는 원래 요청자의 사용자 신원이 필요합니다. 사용자 신원이 없는 API 키나 애플리케이션 token은 자기 애플리케이션의 요청이라도 item_ids를 보내면 403을 받습니다. 생성된 API 키 예시는 본문을 비워 두고 전체 내보내기를 다시 실행합니다.
실제 ID는 비동기 보고서 조회에서 확인하고, 실패 인증 항목 재시도 가이드를 따르세요. 대체 날짜 범위 없이 READY 또는 FAILED 상태의 SESSION_EXPORT에서 1개에서 1000개 사이의 ID를 전송하세요. 삭제된 세션은 재시도할 수 없습니다.

인증

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 를 참고하십시오.

경로 매개변수

organization_id
string<uuid>
필수

조직 ID입니다.

application_id
string<uuid>
필수

애플리케이션 ID입니다.

report_uuid
string<uuid>
필수

보고서 uuid입니다.

본문

application/json
item_ids
string<uuid>[]

이 내보내기에서 실패한 라이브 세션 UUID를 1개에서 1,000개까지 선택하는 옵션입니다. 중복은 하나로 합쳐집니다. 일부만 재시도할 수 있는 사람은 원래 요청자뿐입니다. date_from/date_to와 함께 사용할 수 없습니다.

Required array length: 1 - 1000 elements
date_from
string<date>

선택 사항인 교체 기간 시작일입니다. 두 날짜를 순서대로 보내세요. 실패한 항목 재시도에는 생략합니다.

date_to
string<date>

선택 사항인 교체 기간 종료일로, date_from과 같거나 그 이후 날짜여야 합니다.

notify_on_ready
boolean
기본값:false

요청자 이메일을 사용할 수 있는 경우, 준비가 완료되면 요청자에게 이메일을 보냅니다.

응답

동일한 실패 항목 선택의 재실행입니다. 다른 보고서를 대기열에 추가하지 않고 기존 재시도 보고서를 반환합니다.

uuid
string<uuid>
필수

보고서 식별자입니다.

report_type
enum<string>
필수

내보내기 또는 컴플라이언스 보고서 종류입니다.

사용 가능한 옵션:
SESSION_EXPORT,
TRANSACTION_EXPORT,
BUSINESS_EXPORT,
VENDOR_USER_EXPORT,
VENDOR_BUSINESS_EXPORT,
CASE_EXPORT,
CASE_SLA_EXPORT,
LIST_ENTRY_EXPORT,
EVENT_EXPORT,
COMPLIANCE_KYC_KYB,
COMPLIANCE_AML_LOG,
COMPLIANCE_TRAVEL_RULE,
COMPLIANCE_SANCTIONS_PEP,
COMPLIANCE_RISK_SUMMARY,
COMPLIANCE_SAR_STR_DRAFT,
COMPLIANCE_CTR,
COMPLIANCE_CASE_SUMMARY
report_type_display
string
필수

보고서 종류를 나타내는 표시 레이블입니다.

status
enum<string>
필수

생성 상태입니다. READY 상태에도 개별 실패가 포함될 수 있으므로 failed_count를 확인해야 합니다.

사용 가능한 옵션:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
필수

생성 상태를 나타내는 표시 레이블입니다.

parameters
object
필수

원래 내보내기 옵션입니다. 키는 report_type에 따라 다릅니다.

requested_by_user_id
string<uuid> | null
필수

원래 요청자의 ID입니다. 사용자 ID가 없는 호출자의 경우 null입니다.

requested_by_email
string | null
필수

요청자 이메일입니다. 확인할 수 있는 경우에만 제공됩니다.

requested_by_name
string | null
필수

요청자 표시 이름입니다. 확인할 수 있는 경우에만 제공됩니다.

row_count
integer | null
필수

내보낸 레코드 수입니다. 생성 전에는 null입니다.

failed_item_ids
string<uuid>[]
필수

이 인증 내보내기에서 실패한 라이브 세션 UUID입니다. 삭제된 세션은 제외됩니다. 선택적 재시도에 이 ID를 사용하세요.

failed_count
integer
필수

failed_item_ids의 항목 수입니다.

필수 범위: x >= 0
file_size
integer<int64> | null
필수

생성된 파일의 총 크기(바이트)이며, 생성 전에는 null입니다.

files
object[]
필수

생성된 파일의 메타데이터입니다. 다운로드 URL은 포함되지 않습니다.

scheduled_report
string<uuid> | null
필수

스케줄 식별자이며, 예약되지 않은 보고서인 경우 null입니다.

error_message
string | null
필수

사용할 수 있는 경우 생성 오류입니다.

deletion_pending
boolean
필수

요청된 삭제가 아직 진행 중인지 여부입니다.

eta_seconds
integer | null
필수

대기 중이거나 처리 중인 보고서가 완료되기까지 예상되는 시간(초)입니다. 이력이 없거나 완료된 경우에는 null입니다.

started_at
string<date-time> | null
필수

생성 시작 시각입니다.

completed_at
string<date-time> | null
필수

생성 완료 시각입니다.

expires_at
string<date-time>
필수

보고서 만료 시각입니다.

created_at
string<date-time>
필수

생성 시각입니다.

updated_at
string<date-time>
필수

마지막 업데이트 시각입니다.

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