Method: urls.search

Recherchez les URL correspondant à des menaces connues. Chaque URL, ainsi que ses expressions de suffixe d'hôte et de préfixe de chemin (jusqu'à une profondeur limitée), sont vérifiées. Cela signifie que la réponse peut contenir des URL qui n'étaient pas incluses dans la requête, mais qui sont des expressions des URL demandées.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
urls[]

string

Obligatoire. URL à rechercher. Les clients NE DOIVENT PAS envoyer plus de 50 URL.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse renvoyée après la recherche de menaces correspondant aux URL spécifiées.

Si rien n'est trouvé, le serveur renvoie un état OK (code d'état HTTP 200) avec le champ threats vide, au lieu de renvoyer un état NOT_FOUND (code d'état HTTP 404).

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Champs
threats[]

object (ThreatUrl)

Liste non triée. Liste non ordonnée des correspondances de menaces trouvées. Chaque entrée contient une URL et les types de menaces qui ont été détectés pour cette URL. La taille de la liste peut être supérieure au nombre d'URL dans la requête, car toutes les expressions de l'URL ont été prises en compte.
cacheDuration

string (Duration format)

Durée du cache côté client. Le client DOIT ajouter cette durée à l'heure actuelle pour déterminer l'heure d'expiration. Le délai d'expiration s'applique ensuite à chaque URL interrogée par le client dans la requête, quel que soit le nombre d'URL renvoyées dans la réponse. Même si le serveur ne renvoie aucune correspondance pour une URL spécifique, ce fait DOIT également être mis en cache par le client.

Si et seulement si le champ threats est vide, le client PEUT augmenter cacheDuration pour déterminer une nouvelle date d'expiration ultérieure à celle spécifiée par le serveur. Dans tous les cas, la durée de mise en cache augmentée ne doit pas dépasser 24 heures.

Important : Le client NE DOIT PAS partir du principe que le serveur renverra la même durée de cache pour toutes les réponses. Le serveur PEUT choisir des durées de cache différentes pour différentes réponses en fonction de la situation.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

ThreatUrl

URL correspondant à une ou plusieurs menaces.

Représentation JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Champs
url

string

URL demandée qui correspond à une ou plusieurs menaces.
threatTypes[]

enum (ThreatType)

Liste non triée. Liste non ordonnée des menaces auxquelles l'URL est associée.