- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- ListUpdateRequest
- सीमाएं
- CompressionType
- ListUpdateResponse
- ResponseType
- ThreatEntrySet
- RawHashes
- RawIndices
- RiceDeltaEncoding
- चेकसम
खतरे की सूची से जुड़े सबसे नए अपडेट फ़ेच करता है. क्लाइंट एक साथ कई सूचियों के लिए अपडेट का अनुरोध कर सकता है.
एचटीटीपी अनुरोध
POST https://safebrowsing.googleapis.com/v4/threatListUpdates:fetch
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "client": { object ( |
फ़ील्ड | |
---|---|
client |
क्लाइंट मेटाडेटा. |
listUpdateRequests[] |
अनुरोध की गई खतरे की सूची अपडेट हो जाती है. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"listUpdateResponses": [
{
object ( |
फ़ील्ड | |
---|---|
listUpdateResponses[] |
क्लाइंट की ओर से अनुरोध की गई सूची अपडेट. यहां दिए गए जवाबों की संख्या, क्लाइंट के भेजे गए अनुरोधों की संख्या से कम हो सकती है. उदाहरण के लिए, अगर सर्वर में किसी खास सूची के लिए कोई अपडेट नहीं है, तो ऐसी स्थिति में हो सकते हैं. |
minimumWaitDuration |
वह कम से कम अवधि जिसे कोई भी अपडेट का अनुरोध जारी करने से पहले क्लाइंट को इंतज़ार करना चाहिए. अगर यह फ़ील्ड सेट नहीं किया गया है, तो क्लाइंट इसे जितनी जल्दी चाहे अपडेट कर सकते हैं. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
ListUpdateRequest
सूची को अपडेट करने का एक ही अनुरोध.
जेएसओएन के काेड में दिखाना |
---|
{ "threatType": enum ( |
फ़ील्ड | |
---|---|
threatType |
सूची में मौजूद एंट्री से होने वाले खतरे का टाइप. |
platformType |
सूची में मौजूद एंट्री से, जिस प्लैटफ़ॉर्म को खतरा है उसका टाइप. |
threatEntryType |
सूची में मौजूद एंट्री के टाइप. |
state |
अनुरोध की गई सूची के लिए क्लाइंट की मौजूदा स्थिति (एन्क्रिप्ट की गई क्लाइंट की स्थिति, जो सूची को आखिरी बार अपडेट करने के बाद मिली थी). base64 कोड में बदली गई स्ट्रिंग. |
constraints |
इस अनुरोध से जुड़ी पाबंदियां. |
कंस्ट्रेंट
इस अपडेट की सीमाएं.
जेएसओएन के काेड में दिखाना |
---|
{
"maxUpdateEntries": integer,
"maxDatabaseEntries": integer,
"region": string,
"supportedCompressions": [
enum ( |
फ़ील्ड | |
---|---|
maxUpdateEntries |
एंट्री की ज़्यादा से ज़्यादा संख्या. अपडेट में इस मान से ज़्यादा प्रविष्टियां नहीं होंगी. इसमें 2**10 और 2**20 के बीच 2 की पावर होनी चाहिए. अगर यह संख्या शून्य है, तो अपडेट के लिए साइज़ की कोई सीमा सेट नहीं की गई है. |
maxDatabaseEntries |
यह नीति उन एंट्री की ज़्यादा से ज़्यादा संख्या सेट करती है जो क्लाइंट, दी गई सूची के लिए लोकल डेटाबेस में रखना चाहता है. इसमें 2**10 और 2**20 के बीच 2 की पावर होनी चाहिए. अगर शून्य है, तो डेटाबेस के साइज़ की कोई सीमा सेट नहीं है. |
region |
किसी खास भौगोलिक जगह के लिए सूची का अनुरोध करता है. अगर इस नीति को सेट नहीं किया जाता है, तो सर्वर उपयोगकर्ता के आईपी पते के आधार पर यह वैल्यू चुन सकता है. ISO 3166-1 alpha-2 फ़ॉर्मैट होना ज़रूरी है. |
supportedCompressions[] |
कंप्रेस करने के तरीके, जो क्लाइंट के साथ काम करते हैं. |
language |
किसी खास भाषा के लिए सूचियों का अनुरोध करता है. ISO 639 alpha-2 फ़ॉर्मैट होना ज़रूरी है. |
deviceLocation |
क्लाइंट की जगह की जानकारी, जिसे ISO 31166-1 ऐल्फ़ा-2 इलाके के कोड के तौर पर दिखाया जाता है. |
CompressionType
वे तरीके जिनसे खतरे के एंट्री सेट को कंप्रेस किया जा सकता है.
Enums | |
---|---|
COMPRESSION_TYPE_UNSPECIFIED |
अज्ञात. |
RAW |
रॉ, बिना कंप्रेस किया हुआ डेटा. |
RICE |
Rice-Golomb का एन्कोड किया गया डेटा. |
ListUpdateResponse
हर सूची का अपडेट.
जेएसओएन के काेड में दिखाना |
---|
{ "threatType": enum ( |
फ़ील्ड | |
---|---|
threatType |
किस तरह का खतरा होता है, जिसके लिए डेटा दिखाया जाता है. |
threatEntryType |
खतरों का फ़ॉर्मैट. |
platformType |
वह प्लैटफ़ॉर्म टाइप जिसके लिए डेटा दिखाया जाता है. |
responseType |
जवाब का टाइप. इससे यह पता चलता है कि जवाब मिलने पर क्लाइंट को कोई कार्रवाई करने की ज़रूरत है. |
additions[] |
स्थानीय खतरा प्रकार की सूची में जोड़ने के लिए एंट्री का सेट. इसे एक ही जवाब में, कंप्रेस किए गए और रॉ डेटा के कॉम्बिनेशन को भेजने की अनुमति देने के लिए दोहराया गया है. |
removals[] |
ऐसी एंट्री का सेट जिसे स्थानीय खतरे के टाइप की सूची से हटाया जाना है. व्यावहारिक तौर पर, यह फ़ील्ड खाली है या इसमें सिर्फ़ एक ThreadEntrySet है. |
newClientState |
एन्क्रिप्ट (सुरक्षित) किए गए फ़ॉर्मैट में, क्लाइंट की नई स्थिति. क्लाइंट के लिए ओपेक. base64 कोड में बदली गई स्ट्रिंग. |
checksum |
क्लाइंट स्टेटस का अनुमानित SHA256 हैश. इसका मतलब है कि दिए गए अपडेट को लागू करने के बाद, डेटाबेस में मौजूद सभी हैश की क्रम से लगाई गई सूची की सूची. अगर क्लाइंट की स्थिति उम्मीद के मुताबिक नहीं है, तो क्लाइंट को इस अपडेट को अनदेखा करना होगा और बाद में कोशिश करनी होगी. |
ResponseType
क्लाइंट को भेजे गए जवाब का टाइप.
Enums | |
---|---|
RESPONSE_TYPE_UNSPECIFIED |
अज्ञात. |
PARTIAL_UPDATE |
कुछ हद तक अपडेट, क्लाइंट के मौजूदा लोकल डेटाबेस पर लागू होते हैं. |
FULL_UPDATE |
पूरे अपडेट की मदद से, क्लाइंट का पूरा स्थानीय डेटाबेस बदल जाता है. इसका मतलब है कि या तो क्लाइंट काफ़ी पुराना था या माना जाता है कि वह क्लाइंट खराब है. |
ThreatEntrySet
खतरों का एक ऐसा सेट जिसे क्लाइंट के लोकल डेटाबेस में जोड़ा जाना चाहिए या उससे हटाया जाना चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ "compressionType": enum ( |
फ़ील्ड | |
---|---|
compressionType |
इस सेट में एंट्री के लिए कंप्रेशन टाइप. |
rawHashes |
SHA256 के फ़ॉर्मैट वाली रॉ एंट्री. |
rawIndices |
स्थानीय सूची के लिए रॉ हटाए गए इंडेक्स. |
riceHashes |
SHA256-फ़ॉर्मैट की एंट्री के कोड में बदले गए 4-बाइट प्रीफ़िक्स, जिसमें Golomb-Rice को कोड में बदलने का इस्तेमाल किया जाता है. हैश को uint32 में बदल दिया जाता है और बढ़ते क्रम में रखा जाता है. इसके बाद, डेल्टा कोड की मदद से, कोड में बदले गए डेटा को स्टोर किया जाता है. |
riceIndices |
कोड में बदली गई स्थानीय, लेक्सीकोलॉजिकल तरीके से क्रम में लगाई गई सूची के इंडेक्स. इसमें, गोलमब-राइस कोड को कोड में बदलने का तरीका इस्तेमाल किया जाता है. इसका इस्तेमाल, कंप्रेस किए गए रिमूवल इंडेक्स भेजने के लिए किया जाता है. हटाए गए इंडेक्स (uint32) को बढ़ते क्रम में लगाया जाता है. इसके बाद, डेल्टा को कोड में बदलकर, कोड में बदले गए डेटा के तौर पर सेव किया जाता है. |
RawHashes
किसी खास प्रीफ़िक्स की लंबाई के हैश फ़ॉर्मैट में, बिना कंप्रेस की गई धमकी की एंट्री. हैश का साइज़ 4 से 32 बाइट तक हो सकता है. ज़्यादातर हैश 4 बाइट के होते हैं. हालांकि, कुछ हैश का साइज़ किसी लोकप्रिय यूआरएल के हैश से टकराने पर, वे लंबे हो जाते हैं.
इसका इस्तेमाल, कंप्रेशन की सुविधा न देने वाले या कंप्रेशन की सुविधा देने वाले क्लाइंट को नॉन-4-बाइट हैश भेजने के लिए किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "prefixSize": integer, "rawHashes": string } |
फ़ील्ड | |
---|---|
prefixSize |
नीचे एन्कोड किए गए हर प्रीफ़िक्स के लिए बाइट की संख्या. यह फ़ील्ड 4 (सबसे छोटा प्रीफ़िक्स) से लेकर 32 (फ़ुल SHA256 हैश) तक कहीं भी हो सकता है. |
rawHashes |
बाइनरी फ़ॉर्मैट में, हैश को एक लंबी स्ट्रिंग में इकट्ठा किया जाता है. हैश, लेक्सोग्राफ़िक क्रम में लगाए जाते हैं. JSON API का इस्तेमाल करने वाले लोगों के लिए, हैश को base64 कोड में बदला जाता है. base64 कोड में बदली गई स्ट्रिंग. |
RawIndices
स्थानीय सूची से हटाने के लिए, रॉ इंडेक्स का सेट.
जेएसओएन के काेड में दिखाना |
---|
{ "indices": [ integer ] } |
फ़ील्ड | |
---|---|
indices[] |
शब्दकोश के आधार पर क्रम से लगाई गई स्थानीय सूची से हटाने के लिए इंडेक्स. |
RiceDeltaEncoding
Rice-Golomb का डेटा, कोड में बदला गया है. इसका इस्तेमाल, कंप्रेस किए गए 4-बाइट हैश या कंप्रेस किए गए रिमूवल इंडेक्स भेजने के लिए किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "firstValue": string, "riceParameter": integer, "numEntries": integer, "encodedData": string } |
फ़ील्ड | |
---|---|
firstValue |
कोड में बदले गए डेटा में पहली एंट्री का ऑफ़सेट या सिर्फ़ एक पूर्णांक को कोड में बदलने पर, उस एक पूर्णांक की वैल्यू. अगर फ़ील्ड खाली है या उपलब्ध नहीं है, तो वैल्यू को शून्य मान लें. |
riceParameter |
Golomb-Rice पैरामीटर, जो 2 से 28 के बीच की कोई संख्या होती है. अगर |
numEntries |
कोड में बदले गए डेटा में डेल्टा एंट्री की संख्या. अगर सिर्फ़ एक पूर्णांक को कोड में बदला गया है, तो यह शून्य होगा और सिंगल वैल्यू |
encodedData |
कोड में बदले गए डेल्टा, जिन्हें Golomb-Rice कोडर का इस्तेमाल करके कोड में बदला गया है. base64 कोड में बदली गई स्ट्रिंग. |
चेकसम
क्लाइंट के लोकल डेटाबेस की अनुमानित स्थिति.
जेएसओएन के काेड में दिखाना |
---|
{ "sha256": string } |
फ़ील्ड | |
---|---|
sha256 |
क्लाइंट स्टेट का SHA256 हैश; यानी, डेटाबेस में मौजूद सभी हैश की क्रम से लगाई गई सूची का हैश. base64 कोड में बदली गई स्ट्रिंग. |