Menggunakan Evaluate API

Halaman ini menjelaskan cara menggunakan Evaluate API agar aplikasi klien Anda dapat mengevaluasi potensi bahaya URL. API ini menampilkan skor keyakinan yang menunjukkan potensi bahaya URL berdasarkan daftar yang tidak diizinkan, 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

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

Mengevaluasi URL

Untuk mengevaluasi URL, kirim permintaan HTTP POST 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 threatType: 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 dinonaktifkan lagi di Evaluate API. Lihat API Lookup dan Update untuk opsi bebas crawl.
• Respons HTTP POST 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:

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 -X POST \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY"

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