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