Menggunakan Evaluate API

Halaman ini menjelaskan cara menggunakan Evaluate API untuk memungkinkan aplikasi klien Anda mengevaluasi tingkat bahaya URL. API ini menampilkan skor keyakinan per jenis ancaman yang menunjukkan kemungkinan URL berbahaya. Kemungkinan ini dihitung berdasarkan daftar blokir Penjelajahan Aman, model AI generatif, model machine learning, dan aturan heuristik. Jika Anda menginginkan hasil biner, bukan skor keyakinan , gunakan Lookup API.

Catatan: URL yang dikirimkan ke Evaluate API dapat menjalani pemrosesan tambahan, termasuk crawl.

Sebelum memulai

Fitur ini tersedia dalam pratinjau pribadi untuk sejumlah pelanggan terbatas yang kasus penggunaannya selaras langsung dengan kemampuannya. Hubungi tim penjualan kami untuk meminta tim produk dan teknik kami meninjau kasus penggunaan Anda.

Mengevaluasi URL

Untuk mengevaluasi URL, kirim permintaan POST HTTP ke metode evaluateUri. Pahami pertimbangan berikut saat mengevaluasi URL:

  • Evaluate API mendukung satu URL per permintaan. Jika Anda ingin memeriksa beberapa URL, kirim permintaan terpisah untuk setiap URL.
  • URL harus valid dan tidak perlu dikanonisasi. Untuk mengetahui informasi selengkapnya, lihat RFC 2396.
  • Evaluate API mendukung tiga threatTypes: SOCIAL_ENGINEERING, MALWARE, dan UNWANTED_SOFTWARE.
  • Tidak digunakan lagi. Kolom allow_scan digunakan untuk menentukan apakah Web Risk diizinkan memindai URL yang diberikan. Fungsi ini tidak dapat lagi dinonaktifkan di Evaluate API. Lihat Lookup dan Update API untuk opsi tanpa crawl.
  • Respons POST HTTP menampilkan skor keyakinan untuk threatType yang ditentukan. Skor keyakinan menunjukkan tingkat keyakinan yang menunjukkan seberapa berisiko URL yang ditentukan.

Permintaan API

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

URL: URL yang perlu dievaluasi.

Metode HTTP dan URL: 

POST https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY

Meminta isi JSON: 

{
  "uri": "URL",
  "threatTypes": ["SOCIAL_ENGINEERING", "MALWARE", "UNWANTED_SOFTWARE"]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, lalu jalankan perintah berikut: 

curl -X POST \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY"

PowerShell

Simpan isi permintaan dalam file bernama request.json, lalu jalankan perintah berikut: 

$headers = @{  }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "scores": [
    {
      "threatType": "MALWARE",
      "confidenceLevel": "EXTREMELY_HIGH"
    },
    {
      "threatType": "SOCIAL_ENGINEERING",
      "confidenceLevel": "SAFE"
    },
    {
      "threatType": "UNWANTED_SOFTWARE",
      "confidenceLevel": "SAFE"
    }
  ]
}