MENU
      getInputFileLog

        getInputFileLog


        Article summary

        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:

        MethodURI
        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.

        FieldTypeRequiredDescription
        hashStringRequiredHash value to query
        hashTypeStringRequiredAlgorithm used to create the hash value to query
        • sha1 | md5

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

        Response

        This section describes the response format.

        Response body

        The response body includes the following data:

        FieldTypeRequiredDescription
        returnCodeString-Response code
        returnMessageString-Response message
        inputFileLogList[]Array-Analysis 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[].fileTypeString-Type of file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].fileSizeInteger-Size of file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].parentSha1String-SHA1 hash value of the requested compressed file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].md5String-MD5 hash value of file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].sha1String-SHA1 hash value of file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].sha256String-SHA256 hash value of file analyzed
        • Include only if analyzed files exist
        inputFileLogList[].analysisStatusCodeString-Analysis status code
        • IPRG | CMPL | ERR | EXCN
          • IPRG: analyzing
          • CMPL: analysis completed
          • ERR: analysis error
          • EXCN: exclude analysis
        • Include only if analyzed files exist
        inputFileLogList[].analysisResultCodeString-Analysis 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.