Langsung ke konten utama
POST
curl

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.

Body

application/json
vendor_data
string
wajib

Pengenal internal Anda untuk pengguna akhir yang menjadi cakupan token ini. Diberlakukan sebagai identitas subjek dari setiap transaksi yang dikirimkan bersama token tersebut.

Contoh:

"user-042"

ttl_seconds
integer
default:900

Masa berlaku token dalam detik. Defaultnya 900 (15 menit); maksimum 86400 (24 jam).

Rentang yang diperlukan: x <= 86400
max_uses
integer | null

Jumlah maksimum pengiriman yang berhasil yang diizinkan dengan token ini. Abaikan atau gunakan null untuk penggunaan tanpa batas dalam TTL.

Respons

Token yang diterbitkan. Berikan sdk_token ke aplikasi Anda; token ini mengautentikasi endpoint /v1/transactions/ yang ditujukan untuk perangkat melalui header X-Transaction-Token hingga expires_at.

sdk_token
string

Token transaksi dengan cakupan terbatas untuk diteruskan ke SDK.

expires_at
string<date-time>

Kapan token berhenti diterima.

Terakhir diubah pada 7 November 2026