Nhận nhiều danh sách băm cùng lúc.
Việc khách hàng cần có nhiều danh sách băm là điều rất phổ biến. Phương thức này được ưu tiên hơn việc sử dụng phương thức Get thông thường nhiều lần.
Đây là phương thức Lấy hàng loạt thông thường do https://google.aip.dev/231 xác định và phương thức HTTP cũng là GET.
Yêu cầu HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Tham số | |
---|---|
names[] |
Bắt buộc. Tên của danh sách băm cụ thể. Danh sách này CÓ THỂ là một danh sách mối đe doạ hoặc có thể là Bộ nhớ đệm chung. Tên KHÔNG ĐƯỢC chứa nội dung trùng lặp; nếu có, ứng dụng sẽ gặp lỗi. |
version[] |
Các phiên bản của danh sách băm mà ứng dụng đã có. Nếu đây là lần đầu tiên ứng dụng tìm nạp danh sách băm, bạn nên để trống trường này. Nếu không, ứng dụng phải cung cấp các phiên bản đã nhận được trước đó từ máy chủ. Ứng dụng KHÔNG ĐƯỢC thao tác với các byte đó. Ứng dụng không cần gửi các phiên bản theo cùng thứ tự với tên danh sách tương ứng. Ứng dụng có thể gửi ít hoặc nhiều phiên bản hơn trong một yêu cầu so với tên. Tuy nhiên, ứng dụng KHÔNG ĐƯỢC gửi nhiều phiên bản tương ứng với cùng một tên; nếu đã gửi, ứng dụng sẽ gặp lỗi. Lưu ý trước đây: trong phiên bản 4 của API, API này được gọi là Một chuỗi được mã hoá base64. |
desiredHashLength |
Độ dài tiền tố hàm băm mong muốn của hàm băm được trả về tính bằng byte. Sau đó, máy chủ sẽ trả về tất cả các tiền tố băm trong độ dài đã chỉ định này. Các danh sách băm khác nhau có các yêu cầu khác nhau về các giá trị được chấp nhận của trường Cụ thể, đối với |
sizeConstraints |
Các giới hạn về kích thước trong mỗi danh sách. Nếu bỏ qua thì sẽ không có hạn chế nào. Xin lưu ý rằng kích thước ở đây là theo từng danh sách, không được tổng hợp trên tất cả các danh sách. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi chứa nhiều danh sách hàm băm.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"hashLists": [
{
object ( |
Trường | |
---|---|
hashLists[] |
Danh sách hàm băm theo cùng thứ tự nêu trong yêu cầu. |