Method: hashes.search

Belirtilen öneklerle eşleşen tam karmaları arayın.

Bu, https://google.aip.dev/136 tarafından tanımlandığı gibi özel bir yöntemdir (özel yöntem, bu yöntemin Google'ın genel API geliştirme terminolojisinde özel bir ada sahip olduğunu belirtir; özel bir HTTP yönteminin kullanılmasını belirtmez).

HTTP isteği

GET https://safebrowsing.googleapis.com/v5alpha1/hashes:search

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
hashPrefixes[]

string (bytes format)

Zorunlu. Aranacak karma önekler. İstemciler 1.000'den fazla karma ön ek GÖNDERMEMELİDİR. Ancak, URL işleme prosedürüne göre, istemcilerin 30'dan fazla karma ön eki göndermesi GEREKMEZ.

Şu anda her karma ön ekin tam olarak 4 bayt uzunluğunda olması gerekmektedir. Bu durum ileride yumuşatılabilir.

Base64 kodlu bir dize.
filter

string

İsteğe bağlı. İstemci, yalnızca belirli türdeki tehditleri almak gibi filtreleme yapmakla ilgileniyorsa bu seçenek belirtilebilir. Atlanırsa eşleşen tüm tehditler döndürülür. Güvenli Tarama'nın sunabileceği en kapsamlı korumadan yararlanmak için bu değeri atlamanız önemle tavsiye edilir. Filtre ifadesi söz dizimi için https://google.aip.dev/160 sayfasına göz atın.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Tehdit karmaları arandıktan sonra döndürülen yanıt.

Hiçbir şey bulunmazsa sunucu NOT_FOUND durumu (HTTP durum kodu 404) döndürmek yerine fullHashes alanı boş olacak şekilde bir OK durumu (HTTP durum kodu 200) döndürür.

V5'teki yenilikler: FullHash ile FullHashDetail arasında bir fark vardır. Karma, birden fazla tehdidi olan bir siteyi (ör. hem MALWARE hem de SOCIAL_ENGINEERING) temsil ediyorsa karmanın tamamının, V4'tekinden iki kez gönderilmesine gerek yoktur. Ayrıca, önbellek süresi tek bir cacheDuration alanı olacak şekilde basitleştirildi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "fullHashes": [
    {
      object (FullHash)
    }
  ],
  "cacheDuration": string
}
Alanlar
fullHashes[]

object (FullHash)

Sırasız liste. Bulunan tam karmaların sıralanmamış listesi.
cacheDuration

string (Duration format)

İstemci taraflı önbellek süresi. Müşterinin, son kullanma zamanını belirlemek için bu süreyi geçerli saate eklemesi ZORUNLUDUR. Sonrasında geçerlilik süresi, yanıtta döndürülen tam karmalardan bağımsız olarak, istekteki istemci tarafından sorgulanan her karma ön ek için geçerlidir. Sunucu belirli bir karma ön ek için tam karmalar döndürmese bile, bu bilginin istemci tarafından önbelleğe alınması ZORUNLUDUR.

Önemli: İstemci, sunucunun tüm yanıtlar için aynı önbellek süresini döndüreceğini KABUL ETMEMELİDİR. Sunucu duruma bağlı olarak farklı yanıtlar için farklı önbellek süreleri seçebilir.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir süre. Örnek: "3.5s".

FullHash

Bir veya daha fazla eşleşmeyle tanımlanan tam karma.

JSON gösterimi 
{
  "fullHash": string,
  "fullHashDetails": [
    {
      object (FullHashDetail)
    }
  ]
}
Alanlar
fullHash

string (bytes format)

Eşleşen tam karma. Bu, SHA256 karmasıdır. Uzunluk tam olarak 32 bayt olur.

Base64 kodlu bir dize.
fullHashDetails[]

object (FullHashDetail)

Sırasız liste. Bu tam karma ile ilgili ayrıntıları tanımlayan tekrarlanan bir alan.

FullHashDetail

Eşleşen tam karma ile ilgili ayrıntılar.

İleriye dönük uyumluluk hakkında önemli bir not: Sunucu herhangi bir zamanda yeni tehdit türleri ve tehdit özellikleri ekleyebilir. Bu eklemeler, küçük sürüm değişiklikleri olarak kabul edilir. Google, politikası uyarınca API'lerde alt sürüm numaralarını göstermemelidir (Sürüm oluşturma politikası için https://cloud.google.com/apis/design/versioning adresine bakın). Bu nedenle istemcilerin, istemci tarafından geçersiz olduğu düşünülen ThreatType sıralama değerleri veya ThreatAttribute numaralandırma değerleri içeren FullHashDetail iletilerini almaya hazır olması gerekir. Bu nedenle, tüm ThreatType ve ThreatAttribute enum değerlerinin geçerliliğini kontrol etmek müşterinin sorumluluğundadır. Herhangi bir değer geçersiz sayılırsa istemci FullHashDetail iletisinin tamamını dikkate almamalıdır.

JSON gösterimi 
{
  "threatType": enum (ThreatType),
  "attributes": [
    enum (ThreatAttribute)
  ]
}
Alanlar
threatType

enum (ThreatType)

Tehditin türü. Bu alan hiçbir zaman boş bırakılamaz.
attributes[]

enum (ThreatAttribute)

Sırasız liste. Bu tam karmalarla ilgili ek özellikler. Bu alan boş olabilir.

ThreatAttribute

Tehditlerin özellikleri. Bu özellikler, belirli bir tehdide ek anlam kazandırabilir ancak tehdit türünü etkilemez. Örneğin, bir özellik düşük bir güven değeri belirtirken farklı bir özellik yüksek bir güven değeri belirtebilir. Gelecekte daha fazla özellik eklenebilir.

Sıralamalar
THREAT_ATTRIBUTE_UNSPECIFIED Bilinmeyen özellik. Bu değer sunucu tarafından döndürülürse, istemci kapsayıcı FullHashDetail öğesini tamamen dikkate almaz.
CANARY Tehdit Türünün, yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY ThreatType'ın yalnızca çerçevelere yaptırım uygulamak için kullanılması gerektiğini belirtir.