Menggunakan Evaluate API

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

Catatan: Setiap URL yang dikirim ke Evaluate API dapat menjalani pemrosesan tambahan, termasuk crawling.

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 dikanonikasikan. 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 untuk memindai URL yang diberikan. Fungsi ini tidak dapat lagi dinonaktifkan di Evaluate API. Lihat Lookup dan Update API untuk mengetahui opsi bebas crawling.
  • Respons POST HTTP menampilkan skor keyakinan untuk threatType yang ditentukan. Skor keyakinan mewakili tingkat keyakinan yang menunjukkan tingkat risiko 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"
    }
  ]
}