Method: hashes.search

Belirtilen ön eklerle eşleşen tam karma oluşturma işlemlerini arayın.

Bu, https://google.aip.dev/136 tarafından tanımlanan özel bir yöntemdir (özel yöntem, Google'ın genel API geliştirme terminolojisinde özel bir ada sahip olan bu yöntemi ifade eder; özel bir HTTP yönteminin kullanılmasını ifade etmez).

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
hashPrefixes[]

string (bytes format)

Zorunlu. Aranacak karma değer ön ekleri. Müşteriler 1.000'den fazla karma ön ek göndermemelidir. Ancak URL işleme prosedürü sonrasında istemcilerin 30'dan fazla karma ön ek göndermesi GEREKMEZ.

Şu anda her karma ön ekinin tam olarak 4 bayt uzunluğunda olması gerekir. Bu durum gelecekte GEVŞETİRİLEBİLİR.

Base64 kodlu bir dize.

İ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 bulunamazsa sunucu, NOT_FOUND durumu (HTTP durum kodu 404) yerine fullHashes alanının boş olduğu bir OK durumu (HTTP durum kodu 200) döndürür.

5. sürümdeki yenilikler: FullHash ile FullHashDetail arasında bir ayırma çizgisi vardır. Bir karma değerin birden fazla tehdit içeren bir siteyi temsil ettiği durumlarda (ör. hem MALWARE hem de SOCIAL_ENGINEERING), V4'te olduğu gibi karma değerin tamamının iki kez gönderilmesi gerekmez. Ayrıca, önbellek süresi tek bir cacheDuration alanına 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ırasız listesi.
cacheDuration

string (Duration format)

İstemci tarafı önbelleği süresi. İstemci, geçerli süreyi belirlemek için bu süreyi mevcut süreye eklemelidir. Süre sonu, yanıtta kaç tane tam karma değerin döndürüldüğüne bakılmaksızın istemcide istekte bulunan her karma ön ekinde geçerli olur. Sunucu belirli bir karma ön ekiyle ilgili tam karma değeri döndürmezse bu durum istemci tarafından da önbelleğe ALINMALIDIR.

Yalnızca fullHashes alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir son kullanma tarihi belirlemek için cacheDuration değerini artırabilir. Her durumda, artırılan önbellek süresi 24 saatten uzun olmamalıdır.

Önemli: İstemci, sunucunun tüm yanıtlar için aynı önbellek süresini döndüreceğini VARSAYAMAZ. Sunucu, duruma bağlı olarak farklı yanıtlar için farklı önbelleğe alma süreleri SEÇEBİLİR.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden 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 karma değeridir. Uzunluk tam olarak 32 bayttır.

Base64 kodlu bir dize.
fullHashDetails[]

object (FullHashDetail)

Sırasız liste. Bu tam karma oluşturma işlemiyle ilgili ayrıntıları tanımlayan tekrarlanan bir alan.

FullHashDetail

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

Gelecek uyumluluğuyla ilgili önemli bir not: Sunucu tarafından dilediğiniz zaman yeni tehdit türleri ve tehdit özellikleri eklenebilir. Bu eklemeler küçük sürüm değişiklikleri olarak kabul edilir. Google'ın politikası, API'lerde küçük sürüm numaralarını göstermemektir (sürüm politikası için https://cloud.google.com/apis/design/versioning adresine bakın). Bu nedenle, istemciler ThreatType enum değerleri veya istemci tarafından geçersiz kabul edilen ThreatAttribute enum değerleri içeren FullHashDetail mesajları almaya HAZIR OLMALIDIR. Bu nedenle, tüm ThreatType ve ThreatAttribute enum değerlerinin geçerliliğini kontrol etmek istemcinin sorumluluğundadır. Herhangi bir değer geçersiz kabul edilirse istemcinin FullHashDetail mesajının tamamını yoksaması GEREKİR.

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

enum (ThreatType)

Tehdidin türü. Bu alan hiçbir zaman boş olmaz.
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 katabilir ancak tehdit türünü etkilemez. Örneğin, bir özellik daha düşük güven belirtirken farklı bir özellik daha yüksek güven 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 değerini tamamen yoksayar.
CANARY threatType değerinin yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY threatType değerinin yalnızca çerçevelerde yaptırım için kullanılacağını gösterir.