getInputFileLog
    • PDF

    getInputFileLog

    • PDF

    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'
    

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

    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?

    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.