メインコンテンツへスキップ
POST
Python
Didit の非同期 Reports API は、エクスポートを再実行するか、失敗した認証項目を選択してキューに追加します。新しい再試行は201を返し、同一の失敗項目の選択は既存のレポートを200で返します。
選択的な再試行には、元のリクエストを行ったユーザーのIDが必要です。そのIDを持たないAPIキーまたはアプリケーショントークンは、自身のアプリケーションであっても、item_idsを送信すると403を受け取ります。生成されたAPIキーの例は、空のボディでエクスポート全体を再実行します。
実際のIDは非同期レポートの取得で取得し、失敗項目の再試行ガイダンスに従ってください。置換用の日付範囲を指定せずに、READYまたはFAILEDのSESSION_EXPORTから1から1000件のIDを送信します。削除されたセッションは再試行できません。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンが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〜1000件選択します。重複は1つにまとめられます。サブセットの再試行は元のリクエスト者のみ可能です。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のない呼び出し元の場合は 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日