Langsung ke konten utama
POST
curl
Kredensial ini digunakan oleh jalur perangkat, yang dijelaskan dalam Pengiriman event SDK. Halaman tersebut juga mencantumkan persyaratan apa saja yang diberlakukan oleh server pada setiap permintaan perangkat dan event mana yang aman untuk dibuang saat terjadi backpressure.

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

alias camelCase diterima: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
wajib

ID Anda untuk subjek yang memiliki setiap event yang dikirimkan dengan kredensial ini.

Required string length: 1 - 255
entity_type
string
default:individual

company mengikat subjek perusahaan; nilai lainnya (default individual) mengikat perorangan.

Maximum string length: 32
allowed_event_categories
enum<string>[]

Kategori yang dapat dikirimkan oleh kredensial. Hilangkan atau kirim [] untuk mengizinkan setiap kategori.

Opsi yang tersedia:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
default:900

Masa berlaku kredensial dalam detik.

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

Jumlah event yang dapat dikirimkan oleh kredensial (satu batch menggunakan satu penggunaan untuk setiap event). Kirim null untuk tanpa batas dalam masa berlaku.

Rentang yang diperlukan: x >= 1
bind_to_origin
string | null

Jika diatur, header Origin browser dari setiap permintaan perangkat harus sama persis dengan nilai ini; permintaan tanpa Origin akan ditolak.

Maximum string length: 255

Respons

Kredensial telah diterbitkan. Berikan monitoring_token ke aplikasi dan perlakukan sebagai rahasia hingga expires_at.

monitoring_token
string
wajib

Kredensial perangkat (token URL-safe 43 karakter). Kirim kredensial ini di header X-Monitoring-Token.

expires_at
string<date-time>
wajib

Waktu ketika kredensial tidak lagi diterima.

allowed_event_categories
enum<string>[]
wajib

Kategori yang dapat dikirimkan oleh kredensial; [] berarti setiap kategori.

Opsi yang tersedia:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
wajib

Anggaran peristiwa kredensial; null berarti tidak ada batas.

bind_to_origin
string | null
wajib

Asal tempat kredensial terikat, atau null.

Terakhir diubah pada 7 November 2026