Views:

Last Updated: 1/22/2020 12:11:07 AM

Get summary of top N malwares during a time range

1. It returns the aggregated summary within one day if time range is not specified. 2. The largest query duration is 30 days.

Request

HTTP Request

GET /SMPI/{version}/service/wfbss/api/summary/malwares

Parameters

Name

Type

Description

Validation

Optional Parameters

top

integer

Response top n computers

1 to 100. If not set, default is 100

start_time

integer

Start time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC). end_time - start_time < 30 days

end_time

integer

End time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC). If not set, default is now.

HTTP Request Example

Get summary of top 10 malwares during last one day:
GET /SMPI/{version}/service/wfbss/api/summary/malwares?top=50

Request Body

Do not supply a request body with this method.

Response

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:

{
  "summary": {
    "malwares": [
      {
        "count": 2,
        "type": 2,
        "name": "QETNX_TEST_SPYWARE"
      },
      {
        "count": 2,
        "type": 3,
        "name": "RIHZQ_TEST_NETWORK_VIRUS"
      },
      {
        "count": 2,
        "type": 1,
        "name": "WLCFM_TEST_VIRUS"
      }
    ]
  }
}

Name

Type

Description

Length

summary.malwares[].count

integer

total count of detections

summary.malwares[].type

integer

Malware type

1 = Virus, 2 = Spyware, 3 = Network Virus

summary.malwares[].name

string

Malware name