รับรายการแฮชหลายรายการพร้อมกัน
เป็นเรื่องปกติที่ไคลเอ็นต์จะต้องมีรายการแฮชหลายรายการ แนะนำให้ใช้วิธีการนี้มากกว่าการใช้เมธอด Get ปกติหลายครั้ง
นี่คือเมธอด Get แบบกลุ่มมาตรฐาน ตามที่กำหนดโดย https://google.aip.dev/231 และเมธอด HTTP ก็เป็น GET เช่นกัน
คำขอ HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
names[] |
ต้องระบุ ชื่อของรายการแฮชที่ต้องการ รายการนี้อาจเป็นรายการภัยคุกคาม หรืออาจเป็น Global Cache ชื่อต้องไม่ซ้ำ หากชื่อซ้ำกัน ไคลเอ็นต์จะพบข้อผิดพลาด |
version[] |
เวอร์ชันของรายการแฮชที่ไคลเอ็นต์มีอยู่แล้ว หากไคลเอ็นต์ดึงข้อมูลรายการแฮชเป็นครั้งแรก ควรเว้นช่องนี้ว่างไว้ ไม่เช่นนั้น ไคลเอ็นต์ควรจัดหาเวอร์ชันที่ได้รับจากเซิร์ฟเวอร์ก่อนหน้านี้ ไคลเอ็นต์ต้องไม่จัดการกับไบต์เหล่านั้น ไคลเอ็นต์ไม่จำเป็นต้องส่งเวอร์ชันในลำดับเดียวกันกับชื่อรายการที่เกี่ยวข้อง ไคลเอ็นต์อาจส่งคำขอในเวอร์ชันน้อยกว่าหรือมากกว่าที่มีชื่อ แต่ไคลเอ็นต์ต้องไม่ส่งหลายเวอร์ชันที่สอดคล้องกับชื่อเดียวกัน หากส่ง ไคลเอ็นต์จะพบข้อผิดพลาด หมายเหตุในอดีต: ใน API เวอร์ชัน 4 โดยใช้ชื่อว่า สตริงที่เข้ารหัสฐาน 64 |
desiredHashLength |
ความยาวของคำนำหน้าแฮชที่ต้องการของแฮชที่แสดงผลในหน่วยไบต์ จากนั้นเซิร์ฟเวอร์จะส่งคืนคำนำหน้าแฮชทั้งหมดในความยาวที่ระบุนี้ รายการแฮชที่ต่างกันมีข้อกำหนดที่แตกต่างกันเกี่ยวกับค่าที่ยอมรับได้ของช่อง โดยเฉพาะอย่างยิ่งสำหรับ |
sizeConstraints |
ข้อจำกัดด้านขนาดในแต่ละรายการ หากไม่ระบุ จะไม่มีข้อจำกัดใดๆ โปรดทราบว่าขนาดที่แสดงนี้เป็นขนาดต่อรายการ ไม่ใช่ขนาดในรายการทั้งหมด |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
คำตอบที่มีรายการแฮชหลายรายการ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"hashLists": [
{
object ( |
ช่อง | |
---|---|
hashLists[] |
รายการแฮชในลำดับเดียวกันกับที่ระบุไว้ในคำขอ |