Langsung ke konten utama
POST
curl
Gunakan POST /v3/ip/risk/ saat backend Anda sudah memiliki alamat IP dan memerlukan keputusan risiko server-ke-server. Respons mencakup geolokasi, kepemilikan jaringan, indikator VPN/Tor dan pusat data, data ancaman, serta country_mismatch saat Anda mengirim negara yang diklaim.

Interpretasi respons

  • status bernilai In Review jika negara hasil resolusi bertentangan dengan claimed_country, atau jika alamat terkait dengan infrastruktur VPN, Tor, atau pusat data. Selain itu, nilainya Approved.
  • ip.ip_country_code berisi kode negara hasil resolusi. Bandingkan negara melalui ip.country_mismatch alih-alih membandingkan string negara mentah sendiri.
  • ip.latitude dan ip.longitude adalah geolokasi jaringan perkiraan, bukan lokasi perangkat yang presisi.
  • ip.is_vpn_or_tor, ip.is_data_center, ip.proxy_type, dan ip.threat memuat bukti risiko jaringan.
  • ip.asn_number, ip.asn_organization, ip.connection_type, dan ip.carrier menjelaskan jaringan tempat alamat tersebut berada.
  • request_id adalah ID sesi API. Simpan bersama vendor_data jika Anda perlu mengorelasikan hasil dengan webhook berikutnya atau aktivitas konsol.
Pengayaan IP bersifat upaya terbaik. Jika tidak ada sumber pengayaan yang mengembalikan data yang dapat digunakan, endpoint mengembalikan respons yang disetujui dengan ip.ip_address: null, ip.country_mismatch: null, dan objek ip.threat yang kosong. Kolom pengayaan individual juga dapat bernilai null jika tidak tersedia.

Intelijen perangkat

IP Risk API adalah endpoint server-ke-server murni. Pembuatan sidik jari perangkat tidak bersifat demikian, karena backend tidak dapat mengamati sinyal browser atau perangkat dengan sendirinya. Untuk sesi alur yang di-hosting dan SDK, Didit menampilkan kolom perangkat yang sudah dikumpulkan pada respons sesi, termasuk device_fingerprint, detail perangkat dan browser, user_agent, data perangkat mentah, serta kecocokan lintas sesi.

Perilaku sandbox

Kunci sandbox memvalidasi permintaan dan mengembalikan data yang disetujui secara deterministik. Kunci tersebut tidak menghubungi layanan intelijen eksternal, tidak menggunakan kredit, tidak membuat sesi, dan tidak berkontribusi ke Networks.

Penagihan

Panggilan IP Risk API berbiaya $0.02 pada harga daftar. Permintaan produksi dikenai biaya setelah pencarian dimulai.

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
ip_address
string<ip>
wajib

Alamat IPv4 atau IPv6 yang akan dinilai.

Contoh:

"8.8.8.8"

claimed_country
string

Negara ISO 3166-1 alpha-2 atau alpha-3 opsional yang diklaim oleh pengguna atau sesi. Digunakan untuk menghitung country_mismatch.

Maximum string length: 3
Contoh:

"ESP"

user_agent
string

User agent yang diamati oleh backend Anda. Disimpan sebagai konteks permintaan; ini tidak menyediakan fingerprinting perangkat.

Maximum string length: 512
vendor_data
string

Referensi stabil Anda untuk permintaan ini. Disimpan pada sesi API dan ditampilkan kembali dalam respons.

metadata
object | null

Metadata JSON non-sensitif Anda. Disimpan pada sesi API dan dikembalikan dalam respons.

Respons

Evaluasi risiko selesai. Periksa status untuk melihat keputusannya; HTTP selalu 200 untuk pencarian yang selesai.

request_id
string<uuid>
wajib

Id dari sesi API yang dibuat untuk permintaan ini. Simpan bersama vendor_data jika Anda perlu mengorelasikan hasilnya dengan webhook atau aktivitas konsol berikutnya.

status
enum<string>
wajib

Keputusan untuk sesi API ini: In Review untuk risiko jaringan atau ketidakcocokan negara, jika tidak maka Approved.

Opsi yang tersedia:
Approved,
In Review
created_at
string<date-time>
wajib

Cap waktu respons ini.

vendor_data
string | null

Salinan vendor_data yang Anda kirimkan, atau null jika Anda tidak mengirimkannya.

metadata
object | null

Salinan metadata yang Anda kirimkan, atau null jika Anda tidak mengirimkannya.

ip
object

Hasil risiko IP. Kolom pengayaan individual dapat bernilai null jika pencarian tidak mengembalikan data yang dapat digunakan.

Terakhir diubah pada 7 November 2026