Summary

API for retrieving scan result images, called "badges", which reflect the scan result status of a particular hash. If the hash was scanned by MetaDefender Cloud and there was no threat detected, the "No threat detected" badge will be returned (see a preview below in the "Response" "Body" section). If the hash was detected as infected, the "Threat detected" badge will be returned. If the hash was never scanned by MetaDefender Cloud, the "No information available" badge is displayed.

The point of these badges is to integrate them in your website or application in order to increase the confidence of files provided. For example, a website that offers a software installer package will show this badge with the scan results of the installer saying (ideally) that the file is clean. Here is an html sample code showing the recommended way of integrating this functionality:

Obtaining the badge is straightforward, just compose the URL with the hash of the file, and specify badge type (size and image format). In order for the site visitors to be able to get more information about the scan results of the file, insert the image into an <a> link tag which will open the scan results page on our website.

The "small" badge size can be used in markdown readme files from code repositories.

Request

Response