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
{ "message" : "reason of failure" }
The JSON file has the following structure.
JSON data structure
{ "white": { "items": [ <sha256>, <sha256>, ... ] }, "black": { "items": [ <sha256>, <sha256>, ... ] } }