एक साथ कई हैश सूचियां पाएं.
आम तौर पर, किसी क्लाइंट के लिए एक से ज़्यादा हैश सूचियां पाना ज़रूरी होता है. सामान्य पाएं तरीके का कई बार इस्तेमाल करने के बजाय, इस तरीके का इस्तेमाल करने को प्राथमिकता दी जाती है.
यह एक स्टैंडर्ड बैच पाने का तरीका है, जैसा कि https://google.aip.dev/231 ने तय किया है और एचटीटीपी तरीका भी GET है.
एचटीटीपी अनुरोध
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
names[] |
ज़रूरी है. खास हैश सूचियों के नाम. यह सूची एक खतरे की सूची हो सकती है या वह ग्लोबल कैश भी हो सकती है. नामों में डुप्लीकेट नहीं होने चाहिए. अगर ऐसा है, तो क्लाइंट को गड़बड़ी मिलेगी. |
version[] |
हैश सूची के वर्शन, जो क्लाइंट के पास पहले से मौजूद हैं. अगर क्लाइंट पहली बार हैश सूचियां फ़ेच कर रहा है, तो फ़ील्ड को खाली छोड़ देना चाहिए. अगर ऐसा नहीं है, तो क्लाइंट को उन वर्शन की सप्लाई करनी चाहिए जो पहले सर्वर से मिले थे. क्लाइंट को उन बाइट में हेर-फेर नहीं करना चाहिए. क्लाइंट को वर्शन को उसी क्रम में भेजने की ज़रूरत नहीं है जैसा कि उनसे जुड़ी सूची के नामों में होता है. क्लाइंट, अनुरोध में नामों की तुलना में कम या ज़्यादा वर्शन भेज सकता है. हालांकि, क्लाइंट को एक ही नाम से जुड़े कई वर्शन नहीं भेजने चाहिए. अगर ऐसा हुआ, तो क्लाइंट को गड़बड़ी मिलेगी. पुराना नोट: एपीआई के वर्शन 4 में, इसे base64 कोड में बदली गई स्ट्रिंग. |
desiredHashLength |
लौटाए गए हैश की मनचाहा हैश प्रीफ़िक्स बाइट में. इसके बाद, सर्वर इस तय की गई लंबाई में सभी हैश प्रीफ़िक्स दिखाएगा.
खास तौर पर, |
sizeConstraints |
हर सूची में मौजूद साइज़ की सीमाएं. अगर इसे मिटाया जाता है, तो कोई सीमा नहीं होती. ध्यान दें कि यहां दिए गए साइज़, हर सूची के हिसाब से दिए गए हैं, सभी सूचियों में इकट्ठा नहीं किए गए हैं. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
इस रिस्पॉन्स में, कई हैश सूचियां हैं.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"hashLists": [
{
object ( |
फ़ील्ड | |
---|---|
hashLists[] |
अनुरोध में दिए गए क्रम में हैश की सूचियां. |