getInputFileLogByParentHash
    • PDF

    getInputFileLogByParentHash

    • PDF

    Article summary

    Available in Classic and VPC

    Get the analysis results of the files in the compressed file at once using the hash value of the compressed file requested for analysis through the inputFile API.

    Request

    This section describes the request format. The method and URI are as follows:

    MethodURI
    GET/getInputFileLogByParentHash

    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.

    FieldTypeRequiredDescription
    parentHashStringRequiredHash value of the compressed file
  • sha1
  • fromDateStringConditionalQuery start date and time
  • Enter in timestamp format
  • toDateStringConditionalQuery end date and time
  • Enter in timestamp format
  • Request example

    The request example is as follows:

    curl --location --request GET 'https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLogByParentHash
    ?parentHash=f093e7767bb63ac973b697d3fd1d40a78b87b8bf' \
    --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:

    FieldTypeRequiredDescription
    returnCodeStringRequiredResponse code
    returnMessageStringRequiredResponse message
    inputFileLogList[]ArrayRequiredAnalysis results of the requested file
    • If a file with the same hash is analyzed more than once, it will be listed
    • Display blank if no files were analyzed
    inputFileLogList[].fileTypeStringConditionalFormat of file analyzed
    • Include only if analyzed files exist
    inputFileLogList[].fileSizeIntegerConditionalSize of file analyzed
    • Include only if analyzed files exist
    inputFileLogList[].parentSha1StringConditionalSHA1 hash value of the requested compressed file itself
    • Include only if analyzed files exist
    inputFileLogList[].md5StringConditionalMD5 hash value of the analyzed files in the compressed file
    • Include only if analyzed files exist
    inputFileLogList[].sha1StringConditionalSHA1 hash value of the analyzed files in the compressed file
    • Include only if analyzed files exist
    inputFileLogList[].sha256StringConditionalSHA256 hash value of the analyzed files in the compressed file
    • Include only if analyzed files exist
    inputFileLogList[].analysisStatusCodeStringConditionalAnalysis status code
    • IPRG | CMPL | ERR | EXCN
      • IPRG: analyzing
      • CMPL: analysis completed
      • ERR: analysis error
      • EXCN: exclude analysis
    inputFileLogList[].analysisResultCodeStringConditionalAnalysis result code
    • M | N | E
      • M: malware detected
      • N: malware not detected
      • E: detection error
    • Include only if analyzed files exist
    inputFileLogList[].notifyYmdtLong-Notification delivery time, if set
    • Include only if analyzed files exist
    inputFileLogList[].registrationYmdtLong-File ingest time
    • Include only if analyzed files exist
    Note

    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": [
        ]
    }
    

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.