שימוש ב-Evaluate API

בדף הזה מוסבר איך להשתמש ב-Evaluate API כדי לאפשר לאפליקציות הלקוח שלכם להעריך את מידת הזדוניות של כתובת URL. ממשק ה-API הזה מחזיר ציון מהימנות לכל סוג איום, שמציין את הסבירות שכתובת ה-URL זדונית. הסבירות הזו מחושבת על סמך רשימות חסימה של גלישה בטוחה, מודלים של AI גנרטיבי, מודלים של למידת מכונה וכללים היוריסטיים. אם רוצים לקבל תוצאה בינארית במקום ציון רמת מהימנות, צריך להשתמש ב-Lookup API.

הערה: כתובות URL שנשלחות אל Evaluate API עשויות לעבור עיבוד נוסף, כולל סריקות.

לפני שמתחילים

התכונה הזו זמינה בגרסת טרום-השקה פרטית לקבוצה מוגבלת של לקוחות, שהתרחיש לדוגמה שלהם תואם ישירות ליכולות שלה. אפשר לפנות לצוות המכירות שלנו כדי לבקש מצוותי המוצר וההנדסה שלנו לבדוק את תרחיש השימוש שלכם.

הערכת כתובות URL

כדי להעריך כתובת URL, שולחים בקשת HTTP POST לשיטה evaluateUri. כשמעריכים כתובות URL, חשוב להבין את השיקולים הבאים:

  • ה-API של Evaluate תומך בכתובת URL אחת לכל בקשה. אם רוצים לבדוק כמה כתובות URL, צריך לשלוח בקשה נפרדת לכל כתובת URL.
  • כתובת ה-URL צריכה להיות תקינה, ולא צריך להגדיר אותה כקנונית. מידע נוסף זמין ב-RFC 2396.
  • ה-API של Evaluate תומך בשלושה סוגי איומים: SOCIAL_ENGINEERING, ‏ MALWARE ו-UNWANTED_SOFTWARE.
  • הוצאה משימוש, השדה allow_scan שימש כדי לקבוע אם Web Risk יכול לסרוק את כתובת ה-URL שצוינה. אי אפשר יותר להשבית את הפונקציונליות הזו ב-Evaluate API. אפשר לעיין בממשקי ה-API של Lookup ושל Update כדי לראות אפשרויות שלא דורשות סריקה.
  • תגובת ה-HTTP POST מחזירה ציון רמת סמך עבור threatType שצוין. ציון הסמך מייצג את רמת הסמך שמציינת את רמת הסיכון של כתובת ה-URL שצוינה.

בקשת API

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫URL: כתובת URL שצריך להעריך.

ה-method של ה-HTTP וכתובת ה-URL: 

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

גוף בקשת JSON: 

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

כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

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

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

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