Menggunakan Lookup API
Ringkasan
Lookup API memungkinkan aplikasi klien Anda memeriksa apakah URL termasuk dalam daftar Risiko Web atau tidak.
Memeriksa URL
Untuk memeriksa apakah URL ada dalam daftar Web Risk, kirim permintaan HTTP GET
ke metode
uris.search
:
- Lookup API mendukung satu URL per permintaan. Untuk memeriksa beberapa URL, Anda harus mengirim permintaan terpisah untuk setiap URL.
Anda dapat menentukan beberapa jenis ancaman dalam satu permintaan dengan mengulangi kolom
threatTypes
. Contoh:&threatTypes=SOCIAL_ENGINEERING&threatTypes=MALWARE
URL harus valid (lihat RFC 2396) tetapi tidak perlu dikanonisasi.
Jika menggunakan REST API, Anda harus mengenkode parameter
GET
, seperti URI.Respons HTTP
GET
menampilkan jenis ancaman yang cocok, jika ada, beserta masa berlaku cache.
Contoh: uris.search
Metode HTTP dan URL:
GET https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
"https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY"
PowerShell
Jalankan perintah berikut:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://webrisk.googleapis.com/v1/uris:search?threatTypes=MALWARE&uri=http%3A%2F%2Ftestsafebrowsing.appspot.com%2Fs%2Fmalware.html&key=API_KEY" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "threat": { "threatTypes": [ "MALWARE" ], "expireTime": "2019-07-17T15:01:23.045123456Z" } }
Java
Python
Jika tidak ada hasil yang cocok dengan permintaan Anda, Anda akan mendapatkan respons JSON kosong dari {}
.
Artinya, URL yang Anda berikan tidak ada dalam daftar ancaman.
Durasi cache
Kolom expireTime
menunjukkan stempel waktu saat kecocokan dianggap
telah berakhir. Untuk mengetahui detailnya, lihat Menyimpan ke dalam cache.
Apa langkah selanjutnya?
Pelajari Penggunaan Update API.