Method: hashList.get

آخرین محتویات یک لیست هش را دریافت کنید. یک لیست هش ممکن است با یک لیست تهدید یا یک لیست غیرتهدید مانند کش جهانی باشد.

این یک متد Get استاندارد است که توسط https://google.aip.dev/131 تعریف شده است و روش HTTP نیز GET است.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
name

string

ضروری. نام این لیست هش خاص. ممکن است یک لیست تهدید باشد یا ممکن است کش جهانی باشد.

پارامترهای پرس و جو

مولفه های
version

string ( bytes format)

نسخه هش لیستی که مشتری از قبل دارد. اگر این اولین بار است که مشتری لیست هش را واکشی می کند، این قسمت باید خالی بماند. در غیر این صورت، کلاینت باید نسخه ای را که قبلاً از سرور دریافت کرده است، ارائه دهد. کلاینت نباید آن بایت ها را دستکاری کند.

چه چیزی در V5 جدید است : در V4 از API، این states نامیده می شد. اکنون برای وضوح به version تغییر نام داده شده است.

رشته ای با کد base64.

desiredHashLength

enum ( HashLength )

طول پیشوند هش مورد نظر هش های برگشتی بر حسب بایت. سپس سرور تمام پیشوندهای هش را در این طول مشخص شده برمی گرداند.

لیست های هش مختلف دارای الزامات متفاوتی در مقادیر قابل قبول فیلد desiredHashLength نظر هستند. این را می توان در قسمت supportedHashLengths در HashListMetadata یافت. اگر desiredHashLength مقداری را در supportedHashLengths مشخص نکند، یک خطا برگردانده خواهد شد.

sizeConstraints

object ( SizeConstraints )

محدودیت اندازه در لیست اگر حذف شود، هیچ محدودیتی وجود ندارد. محدودیت ها برای همه دستگاه هایی با قدرت پردازش، پهنای باند یا ذخیره سازی محدود توصیه می شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه از HashList است.