- Print
- PDF
getInputFileLog
- Print
- PDF
Available in Classic and VPC
Get the results of file filter analysis of a file sent via the inputFile API.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
GET | /getInputFileLog |
Request headers
For information about the headers common to all File Safer APIs, see Common File Safer API headers.
Request parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
hash | String | Required | Hash value to query |
hashType | String | Required | Algorithm used to create the hash value to query
|
Request example
The request example is as follows:
curl --location --request GET 'https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLog
?hash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf
&hashType=sha1' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-api-key: {API Gateway API Key}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
returnCode | String | - | Response code |
returnMessage | String | - | Response message |
inputFileLogList[] | Array | - | Analysis results of the requested file
|
inputFileLogList[].fileType | String | - | Type of file analyzed
|
inputFileLogList[].fileSize | Integer | - | Size of file analyzed
|
inputFileLogList[].parentSha1 | String | - | SHA1 hash value of the requested compressed file analyzed
|
inputFileLogList[].md5 | String | - | MD5 hash value of file analyzed
|
inputFileLogList[].sha1 | String | - | SHA1 hash value of file analyzed
|
inputFileLogList[].sha256 | String | - | SHA256 hash value of file analyzed
|
inputFileLogList[].analysisStatusCode | String | - | Analysis status code
|
inputFileLogList[].analysisResultCode | String | - | Analysis result code
|
inputFileLogList[].notifyYmdt | Long | - | Notification delivery time, if set
|
inputFileLogList[].registrationYmdt | Long | - | File ingest time
|
The serviceCode
and applicationCode
may be displayed in the response results, but they are not fields that users should refer to.
Response status codes
For information about the HTTP status codes common to all File Safer APIs, see File Safer response status codes.
Response example
The response example is as follows:
If you have analyzed files
The following is a sample response if you have analyzed files.
{
"returnCode": "0",
"returnMessage": "success",
"inputFileLogList": [
{
"fileType": "Adobe Portable Document Format",
"fileSize": 68584,
"parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
"md5": "83861ed7105eb8b9886616f9f0428b62",
"sha1": "ea445bec4e8f79c5a2f8db5a368f2c3c741e238f",
"sha256": "ff8ca1b607ab03268078d9bde33980e16ca45aa3c798e2b963ca89efd87714cc",
"analysisStatusCode": "CMPL",
"analysisResultCode": "N",
"notifyYmdt": null,
"registrationYmdt": 1697766000000,
"serviceCode": null,
"applicationCode": null
},
{
"fileType": "Adobe Portable Document Format",
"fileSize": 56686,
"parentSha1": "4fa122a164fab49701d440dc376a108b2ab71bc4",
"md5": "e162e32656ff4b4666d14bc43f9238c1",
"sha1": "d4021b08bcaa08255afd1b80bf9c39ab46116447",
"sha256": "40aa534c3cd62f4d7585a9bbf06a4af23b771d8b39127f16b2ec2503bffcd4aa",
"analysisStatusCode": "CMPL",
"analysisResultCode": "N",
"notifyYmdt": null,
"registrationYmdt": 1697766000000,
"serviceCode": null,
"applicationCode": null
}
]
}
If you don't have analyzed files
The following is a sample response if you don't have analyzed files.
{
"returnCode": "0",
"returnMessage": "success",
"inputFileLogList": [
]
}