Blacklist
blacklist
Request method: GET
Description: Returns a list of blacklisted hashes for the system
Output: data {id, md5sum, threat_score, ctime, file_cksum_id}; extraPKValue; positionInTable: {offset}
Response codes:
200 OK
- List of Whitelists are returned
blacklist/create
Request method: POST
Description: Adds a new MD5 hash to the blacklist. The hash must be supplied in a JSON format with the hash, and a threat score, in the request body, with the following structure:[{"md5sum":"01a0d01a2f78d8efaa55a3585713c0ba",
"threat_score":10}]
If a hash already exists, it will be returned in the duplicate
key instead of the added
key.
Output: duplicate; added: {id, md5sum, threat_score, ctime, file_cksum_id}
Response codes:
200 OK
- Hash was created
400 Bad Request
- The hash could not be added, see the errors
key in the response
blacklist/delete
Request method: POST
Description: Removes a blacklisted hash from the system. The data must be supplied in a JSON format in the body, with the following structure:
["01a0d01a2f78d8efaa55a3585713c0ba"]
Response codes:
204 No Content
- Hash was deleted
blacklist/update
Request method: POST
Description: Updates a blacklisted hash with new data. The data must be supplied in a JSON format in the body, with the following structure:
{"id":2,"md5sum":"01a0d01a2f78d8efaa55a3585713c0ba",
"threat_score":"5","ctime":"2016-09-08 18:05:53",
"file_cksum_id":null,"$index":0,"$updating":true}
Output: id, md5sum, threat_score, ctime, file_cksum_id
Response codes:
200 OK
- Hash was update
400 Bad Request
- There was an issue updating the hash. See the errors
key in the response.