Langsung ke konten utama
GET
cURL

Otorisasi

Authorization
string
header
wajib

access_token JWT bertanda tangan RS256 yang dikembalikan oleh POST /programmatic/login/ atau POST /programmatic/verify-email/. Kirim sebagai Authorization: Bearer <access_token>. Masa berlaku default adalah 86400 detik (24 jam). Token ini hanya valid untuk endpoint Manajemen Akun di apx.didit.me/auth/v2. Sebagai gantinya, API verifikasi (verification.didit.me/v3) menggunakan api_key berjangka panjang sebagai x-api-key.

Parameter Path

org_id
string<uuid>
wajib

UUID dari organisasi pemilik aplikasi.

Contoh:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
wajib

UUID dari aplikasi yang kredensialnya ingin Anda baca.

Contoh:

"b2c3d4e5-6789-01bc-defg-222222222222"

Respons

Catatan aplikasi termasuk client_id dan api_key miliknya.

Catatan aplikasi lengkap. Nilai uuid, client_id, dan api_key tidak pernah berubah setelah pembuatan. Begitu pula dengan data_location, kecuali satu kali pada aplikasi produksi yang dibuat bersama organisasi Anda, sebelum digunakan (lihat permintaan pembaruan).

uuid
string<uuid>

UUID aplikasi. Gunakan sebagai {app_id} dalam panggilan berikutnya.

Contoh:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Nama tampilan aplikasi yang ditampilkan di konsol Didit.

Contoh:

"Acme Production App"

client_id
string

Pengenal klien publik, aman untuk disematkan dalam alur bergaya OAuth.

Contoh:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Rahasia jangka panjang (juga disebut client_secret). Gunakan sebagai header x-api-key untuk setiap panggilan ke https://verification.didit.me/v3/... (sesi, alur kerja, AML, dll.). Perlakukan sebagai kredensial; jangan pernah mengeksposnya di sisi klien. Kunci baru diawali dengan sk_live_ (aplikasi produksi) atau sk_test_ (aplikasi sandbox), diikuti oleh 43 karakter aman-URL (huruf, angka, -, dan _). Kunci yang dibuat sebelum format ini tidak memiliki awalan dan tetap berfungsi tanpa perubahan. Selama 72 jam setelah Anda memulihkan akun, operasi daftar, ambil, dan perbarui mengembalikan string kosong di sini alih-alih kunci.

Contoh:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL situs web atau aplikasi yang terkait dengan aplikasi ini.

Contoh:

"https://acme.example"

redirect_uris
string[]

URI pengalihan yang diizinkan untuk alur pengalihan gaya OAuth dan verifikasi.

Contoh:
terms_url
string | null

URL ketentuan layanan yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/terms"

privacy_url
string | null

URL kebijakan privasi yang ditampilkan dalam alur verifikasi.

Contoh:

"https://acme.example/privacy"

description
string | null

Deskripsi internal untuk aplikasi (tidak ditampilkan kepada pengguna akhir).

created_at
string<date-time>
Contoh:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Tempat data verifikasi aplikasi disimpan dan diproses, dipilih saat aplikasi dibuat. eu adalah Uni Eropa (Irlandia), sebagai default. au (Australia, Sydney) dan mx (Meksiko) akan segera hadir: permintaan yang mencantumkannya akan menghasilkan respons 400 This data location is not available yet. Aplikasi Sandbox suatu organisasi selalu berada di Uni Eropa.

Opsi yang tersedia:
eu,
au,
mx
Contoh:

"eu"

products
object[]
read-only

Produk aplikasi. Selalu ketiganya, dalam urutan ini: identity, transactions, authentication. Aplikasi baru memiliki identity yang diaktifkan dengan semua modul aktif, serta transactions dan authentication dinonaktifkan. Hanya baca: kunci products dalam body pembuatan atau pembaruan akan diabaikan.

Contoh:
Terakhir diubah pada 7 November 2026