MENU
      getInputFileLogByParentHash

        getInputFileLogByParentHash


        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'
        Shell

        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
                }
            ]
        }
        JSON

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

        Was this article helpful?

        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.