Langsung ke konten utama
GET
curl
Baca ekspor yang dimulai dengan Ekspor file.
  • PENDING dan PROCESSING: ZIP sedang disiapkan. Baca ulang ekspor dalam beberapa detik.
  • READY: download_url adalah tautan yang ditandatangani ke ZIP yang tetap berlaku untuk waktu singkat. Baca ulang ekspor untuk mendapatkan tautan baru sampai expires_at.
  • FAILED: ZIP tidak dapat disiapkan. Mulai ekspor baru.
  • EXPIRED: ZIP telah dihapus. Mulai ekspor baru.
Setiap permintaan pembacaan yang memberikan tautan unduhan dicatat ke log audit sesi. Ekspor dari sesi yang telah dihapus mengembalikan 404.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

sessionId
string<uuid>
wajib

UUID sesi verifikasi (session_id yang dikembalikan oleh POST /v3/session/). Menerima ID sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Sesi yang dihapus mengembalikan 404.

Contoh:

"11111111-2222-3333-4444-555555555555"

exportId
string<uuid>
wajib

export_id yang dikembalikan oleh POST /v3/session/{sessionId}/files-export/.

Contoh:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Respons

Ekspor.

Satu file ZIP berisi setiap file dari sebuah sesi, dalam kualitas asli.

export_id
string<uuid>
wajib

ID ekspor. Teruskan ke GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
wajib

Sesi asal file-file tersebut.

status
enum<string>
wajib

PENDING dan PROCESSING saat ZIP sedang disiapkan, READY setelah dapat diunduh, FAILED ketika tidak dapat disiapkan (minta ekspor baru), EXPIRED setelah ZIP dihapus.

Opsi yang tersedia:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
wajib

File di dalam ZIP. Diatur hanya ketika status bernilai READY.

size_bytes
integer<int64> | null
wajib

Ukuran ZIP dalam bita. Diatur hanya saat status adalah READY.

download_url
string<uri> | null
wajib

URL ZIP yang ditandatangani, valid untuk waktu singkat. Diatur hanya saat status adalah READY; baca ekspor lagi untuk mendapatkan yang baru.

expires_at
string<date-time> | null
wajib

Waktu ketika ZIP dihapus, 24 jam setelah siap. Hanya diatur selama status bernilai READY.

error
string | null
wajib

Alasan mengapa ekspor gagal, saat status adalah FAILED.

created_at
string<date-time>
wajib

Waktu ketika ekspor diminta.

completed_at
string<date-time> | null
wajib

Waktu ketika ZIP siap atau ekspor gagal.

Terakhir diubah pada 7 November 2026