Aynı anda birden fazla karma listesi alabilirsiniz.
Bir istemcinin birden çok karma listesi alması çok yaygın görülen bir durumdur. Normal Get yöntemini birden çok kez kullanmak yerine bu yöntemin kullanılması tercih edilir.
Bu, https://google.aip.dev/231 tarafından tanımlandığı şekliyle standart bir toplu Get yöntemidir ve HTTP yöntemi de GET'dir.
HTTP isteği
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
names[] |
Zorunlu. Belirli karma listelerinin adları. Liste, bir tehdit listesi OLABİLİR veya Genel Önbellek olabilir. Adların yinelenen öğeler İÇERMEMESİ ZORUNLUDUR; yinelenen adlar içeriyorsa istemci hata alır. |
version[] |
İstemcinin zaten sahip olduğu karma liste sürümleri. İstemci karma listelerini ilk kez alıyorsa bu alan boş bırakılmalıdır. Aksi takdirde, istemcinin daha önce sunucudan aldığı sürümleri sağlaması gerekir. İstemci bu baytları DEĞİŞTİRMEMELİDİR. İstemcinin sürümleri ilgili liste adlarıyla aynı sırada göndermesine gerek yoktur. İstemci, bir istekte, mevcut sürümden daha az veya daha fazla sürüm gönderebilir. Ancak, istemci aynı ada karşılık gelen birden çok sürüm GÖNDERMEMELİDİR. Gönderdiyse, istemci bir hata alır. Geçmişe ilişkin not: API'nin V4'te adı Base64 kodlu bir dize. |
desiredHashLength |
Döndürülen karmaların bayt cinsinden istenen karma ön eki uzunluğu. Ardından sunucu, belirtilen bu uzunluktaki tüm karma önekleri döndürür. Farklı karma listelerin, Özellikle |
sizeConstraints |
Her bir listedeki boyut sınırlamaları. Atlanırsa herhangi bir sınırlama olmaz. Buradaki boyutların liste başına olduğunu, tüm listeler genelinde toplanmadığını unutmayın. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Yanıt birden fazla karma liste içeriyor.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"hashLists": [
{
object ( |
Alanlar | |
---|---|
hashLists[] |
Karma, istekte belirtilen sırada listelenir. |