Method: fullHashes.find
هش های کاملی را پیدا می کند که با پیشوندهای هش درخواستی مطابقت دارند.
درخواست HTTP
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"client": {
object (ClientInfo )
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo )
},
"apiClient": {
object (ClientInfo )
}
} |
فیلدها |
---|
client | object ( ClientInfo ) فراداده مشتری |
clientStates[] | string ( bytes format) کلاینت فعلی برای هر یک از لیست های تهدید محلی مشتری، حالت می دهد. رشته ای با کد base64. |
threatInfo | object ( ThreatInfo ) لیست ها و هش هایی که باید بررسی شوند. |
apiClient | object ( ClientInfo ) فراداده های مشتری مرتبط با تماس گیرندگان API های سطح بالاتر که بر روی پیاده سازی مشتری ساخته شده اند. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"matches": [
{
object (ThreatMatch )
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
فیلدها |
---|
matches[] | object ( ThreatMatch ) هش کامل که با پیشوندهای درخواستی مطابقت دارد. |
minimumWaitDuration | string ( Duration format) حداقل مدت زمانی که مشتری باید قبل از صدور هرگونه درخواست هش یافتن منتظر بماند. اگر این فیلد تنظیم نشده باشد، مشتریان می توانند به محض اینکه بخواهند درخواستی را صادر کنند. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" . |
negativeCacheDuration | string ( Duration format) برای نهادهای درخواستی که با لیست تهدید مطابقت ندارند، چه مدت باید پاسخ را در حافظه پنهان نگه دارید. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" . |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی."],[[["This API finds full hashes that match requested hash prefixes using a POST request to `https://safebrowsing.googleapis.com/v4/fullHashes:find`."],["The request body includes client metadata, client states, threat information, and API client details, structured according to the provided JSON schema."],["The response body provides matching full hashes, minimum wait duration before the next request, and negative cache duration for non-matching entities, all formatted as described in the schema."]]],["This document details the process for finding full hashes matching requested hash prefixes via the `fullHashes:find` API. A `POST` request to the specified URL includes a JSON request body with client metadata (`client`, `apiClient`), client states (`clientStates`), and threat information (`threatInfo`). The response, if successful, contains matched full hashes (`matches`), a minimum wait duration (`minimumWaitDuration`) before the next request, and a negative cache duration (`negativeCacheDuration`).\n"]]