File API Endpoint
This API endpoint allows downloading any processed or extracted (e.g. image embedded in a document) binary file. In order to retrieve a file, the SHA256 digest needs to be known. The reporting data as returned by /task will contain a variety of digests. The retrieved binary data is contained within the JSON response as a Base64 string. The decoded string is either the raw data or an inflated gzipped version (default). Using the "uncompressed" flag allows determining whether the decoded string is compressed or not.
Note: the "mediaType" returned is the media type of the underlying file.
Syntax
GET https://<ip>:<port>/file
Parameters
Name | Type | Required? | Description |
---|---|---|---|
serect | String | Y | Authentication secret |
sha256 | String | Y | SHA256 digest as found in the response of /submit or extracted resource in the reporting |
uncompressed | Boolean | N | Determines whether the decoded Base64 data blob is gzip compressed or not. By default, the parameter is set to "false" |
Example response
{
"processTime": 29,
"fileSize": 298083,
"mediaType":
{
"string": "text/plain",
"slash": 4,
"semicolon": 10,
"parameters":
{}
},
"digests":
{
"SHA-1": "89f1e80601aad4a29f6b0d9dac27dbbc8043911e",
"SHA-256": "ded996a1b8ecb407d0e33d2177d50ade036cbe8d1680dda4329bbd878f433ac1",
"SHA-512": "2f28c0e765d031bbf166223ab5b732a7c8308c6421233ae776414938066e-2b082ae1f0799b56e0feb7e5da430e315b1ff0b1a60f6b47d36c22548c56a2d2c00d",
"MD5": "e82aded7b074aaa0110445219bdbc6a1"
},
"base64": "KjFkN0hQY1ljUE5O(..)"
}
Was this page helpful?