Method: hashList.get

Nhận nội dung mới nhất của danh sách băm. Danh sách băm có thể theo một danh sách mối đe doạ hoặc danh sách không phải mối đe doạ, chẳng hạn như Bộ nhớ đệm chung.

Đây là phương thức Get tiêu chuẩn theo quy định của https://google.aip.dev/131 và phương thức HTTP cũng là GET.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của danh sách băm cụ thể này. Đây có thể là một danh sách mối đe doạ hoặc có thể là Bộ nhớ đệm chung.

Tham số truy vấn

Tham số
version

string (bytes format)

Phiên bản 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, thì trường này PHẢI để trống. Nếu không, ứng dụng PHẢI cung cấp phiên bản trước đó đã nhận được từ máy chủ. Ứng dụng KHÔNG ĐƯỢC thao tác với các byte đó.

Có gì mới trong V5: trong phiên bản 4 của API, API này được gọi là states; hiện được đổi tên thành version để cho rõ ràng hơn.

Một chuỗi được mã hoá base64.

desiredHashLength

enum (HashLength)

Độ 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 desiredHashLength. Bạn có thể tìm thấy thông tin này ở trường supportedHashLengths trên HashListMetadata. Nếu desiredHashLength không chỉ định giá trị trong supportedHashLengths, hệ thống sẽ trả về lỗi.

sizeConstraints

object (SizeConstraints)

Các điều kiện ràng buộc về kích thước trong danh sách. Nếu bỏ qua thì sẽ không có hạn chế nào. Bạn nên sử dụng các quy tắc ràng buộc trên tất cả các thiết bị có công suất xử lý, băng thông hoặc bộ nhớ hạn 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

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của HashList.