Langsung ke konten utama
PATCH
cURL
Gunakan endpoint ini untuk memastikan setiap aplikasi selaras dengan pelanggan, merek, lingkungan, atau kasus penggunaan internal yang diwakilinya. Untuk reseller, endpoint ini memungkinkan Anda mengganti nama atau memperbarui setiap aplikasi pelanggan tanpa membagikan kredensial antar pelanggan. Untuk pelanggan langsung, endpoint ini membantu memisahkan produk, wilayah, atau lingkungan sambil tetap menyimpan semuanya di bawah satu organisasi.
Endpoint ini memperbarui metadata aplikasi. api_key tetap sama kecuali Anda merotasi kredensial secara terpisah.

Lokasi data

Lokasi data aplikasi (data_location) dipilih saat aplikasi dibuat dan tidak dapat diubah setelahnya: pembaruan yang menyebutkan lokasi yang sudah dimiliki aplikasi akan diterima, sedangkan lokasi lain akan menghasilkan respons 400. Satu-satunya pengecualian adalah aplikasi produksi yang dibuat bersama organisasi Anda, saat pendaftaran atau melalui Verifikasi Email. Pembaruan pertama yang menyebutkan data_location akan menetapkan lokasinya, sekali saja, selama tidak ada kunci API aplikasi yang pernah digunakan dan aplikasi belum memiliki sesi verifikasi. Langkah Beri nama aplikasi pertama Anda di konsol menggunakan mekanisme ini untuk menyimpan lokasi yang Anda pilih di sana. Saat ini, satu-satunya lokasi yang tersedia adalah eu, Uni Eropa (Irlandia).

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 akan diperbarui.

Contoh:

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

Body

application/json

Kirim hanya kolom yang ingin Anda ubah. Semantik PATCH: kolom yang tidak disertakan akan dipertahankan.

Isi (body) PATCH untuk metadata aplikasi. Kirim hanya kolom yang ingin Anda ubah; kolom yang diabaikan tetap dipertahankan. uuid, client_id, dan api_key tidak dapat diperbarui. products bersifat hanya-baca: kunci products dalam body akan diabaikan. data_location tidak dapat diubah setelah aplikasi dibuat: menyebutkan lokasi yang sudah dimilikinya akan diterima, dan lokasi lain mana pun akan menghasilkan respons 400. Satu pengecualian adalah aplikasi produksi yang dibuat bersama organisasi Anda: pembaruan pertama yang menyebutkan data_location akan memilihnya, sekali saja, selama belum ada kunci API dari aplikasi yang digunakan dan aplikasi tersebut tidak memiliki sesi verifikasi.

name
string

Nama tampilan aplikasi.

Contoh:

"Acme Production App"

website_url
string

URL situs web atau aplikasi yang terkait dengan aplikasi ini.

Contoh:

"https://app.acme.example"

redirect_uris
string[]

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

Contoh:
terms_url
string

URL ketentuan layanan yang ditampilkan dalam alur verifikasi.

privacy_url
string

URL kebijakan privasi yang ditampilkan dalam alur verifikasi.

description
string

Deskripsi internal untuk aplikasi.

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"

Respons

Aplikasi diperbarui. Responsnya adalah catatan aplikasi lengkap setelah perubahan, termasuk products; uuid, client_id, dan api_key tidak berubah.

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