Method: hashList.get

รับเนื้อหาล่าสุดของรายการแฮช รายการแฮชอาจเป็นรายการภัยคุกคามหรือรายการที่ไม่ใช่ภัยคุกคาม เช่น แคชส่วนกลาง

นี่คือเมธอด Get มาตรฐานตามที่ระบุไว้ใน https://google.aip.dev/131 และเมธอด HTTP ก็เป็น GET ด้วย

คำขอ HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อของรายการแฮชนี้ ซึ่งอาจเป็นรายการภัยคุกคามหรือแคชส่วนกลางก็ได้

พารามิเตอร์การค้นหา

พารามิเตอร์
version

string (bytes format)

เวอร์ชันของรายการแฮชที่ไคลเอ็นต์มีอยู่แล้ว หากเป็นครั้งที่ลูกค้าดึงข้อมูลรายการแฮชเป็นครั้งแรก ช่องนี้ต้องว่างเปล่า ไม่เช่นนั้นไคลเอ็นต์ควรระบุเวอร์ชันที่ได้รับจากเซิร์ฟเวอร์ก่อนหน้านี้ ไคลเอ็นต์ต้องไม่ดัดแปลงไบต์เหล่านั้น

มีอะไรใหม่ในเวอร์ชัน 5: ใน API เวอร์ชัน 4 ฟีเจอร์นี้เรียกว่า states แต่ตอนนี้เปลี่ยนชื่อเป็น version เพื่อให้ชัดเจน

สตริงที่เข้ารหัส Base64
desiredHashLength
(deprecated)

enum (HashLength)

ความยาวของคำนำหน้าแฮชที่ต้องการของแฮชที่แสดงผลเป็นไบต์ จากนั้นเซิร์ฟเวอร์จะแสดงผลคำนำหน้าแฮชทั้งหมดที่มีความยาวตามที่ระบุ

รายการแฮชแต่ละรายการมีข้อกำหนดที่แตกต่างกันสำหรับค่าที่ยอมรับได้ของช่อง desiredHashLength ซึ่งดูได้ในช่อง supportedHashLengths ใน HashListMetadata หาก desiredHashLength ไม่ได้ระบุค่าภายใน supportedHashLengths ระบบจะแสดงข้อผิดพลาด
sizeConstraints

object (SizeConstraints)

ข้อจำกัดด้านขนาดของรายการ หากไม่ระบุ ระบบจะไม่มีข้อจำกัด เราขอแนะนำให้ใช้ข้อจำกัดกับอุปกรณ์ทั้งหมดที่มีกำลังการประมวลผล แบนด์วิดท์ หรือพื้นที่เก็บข้อมูลจำกัด

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ HashList