Menggunakan Evaluate API

Halaman ini menjelaskan cara menggunakan Evaluate API agar aplikasi klien Anda dapat mengevaluasi tingkat bahaya suatu URL. API ini menampilkan skor keyakinan yang menunjukkan kejahatan URL berdasarkan daftar yang tidak diizinkan, model machine learning, dan aturan heuristik. Jika Anda menginginkan hasil biner, bukan skor keyakinan, gunakan Lookup API.

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

Sebelum memulai

Hubungi tim penjualan kami atau engineer pelanggan Anda untuk mendapatkan akses ke fitur ini.

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 dikanonikalisasi. Untuk mengetahui informasi selengkapnya, lihat RFC 2396.
  • Evaluate API mendukung tiga jenis ancaman: SOCIAL_EngineERING, MALWARE, dan UNWANTED_SOFTWARE.
  • Tidak digunakan lagi. Kolom allow_scan digunakan untuk menentukan apakah Web Risk diizinkan untuk memindai URL yang diberikan. Fungsi ini tidak dapat lagi dinonaktifkan di Evaluate API. Lihat API Lookup dan Update untuk mendapatkan opsi bebas 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

Isi JSON permintaan: 

{
  "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"
    }
  ]
}