Wblist endpoint

The wblist endpoint allows clients to get the latest restricted and allowed list of file hashes available.

Request

Item

Description

URL

GET /wblist

Parameters

after (int, optional): Unix time stamp truncated to the second.

Examples

GET /wblist?after=1470700100

Headers

It is recommended that you pass the Accept-Encoding: gzip header in order to compress the result.

Response

A successful response returns status code 302. In the response header, the location field contains the URL the client is being redirected to and where the document containing the restricted and allowed list of file hashes is found. If the client requests a compressed, gzip version, the document is gzipped. The URL expires in 1 day.

If an error occurred, the service returns either 400 or 503. For any of these response codes, the body contains the following JSON documentation with a message field describing the error.

Allowed/Restricted endpoint response
JSON
{
    "message" : "reason of failure"
}

The JSON file has the following structure.

JSON data structure
JSON
{
    "white": {
        "items": [
            <sha256>,
            <sha256>,
            ...
        ]
    },
    "black": {
        "items": [
            <sha256>,
            <sha256>,
            ...
        ]
    }
}