---
title: "checkHash"
slug: "security-filesafer-checkhash"
updated: 2026-09-17T09:58:23Z
published: 2026-09-17T09:58:23Z
canonical: "api.ncloud-docs.com/security-filesafer-checkhash"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# checkHash

Classic/VPC環境で利用できます。

Hash値を利用して、ファイルまたは URLストリングが悪性かどうかを Hash Filterを通じて確認します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /hashfilter/v1/checkHash |

### リクエストヘッダ

File Safer APIで共通して使用されるヘッダの詳細は、[File Safer APIのリクエストヘッダ](/docs/ja/security-filesafer#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

パラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `hashCode` | String | Required | 照会対象の Hash |
| `hashType` | String | Required | 照会対象の Hashの作成に使用したアルゴリズム - `sha1` \| `md5` |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request GET 'https://filesafer.apigw.ntruss.com/hashfilter/v1/checkHash?hashCode=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'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `returnCode` | String | Required | リクエストの処理結果コード |
| `returnMessage` | String | Required | リクエストの処理結果メッセージ |
| `totalRows` | Integer | Required | `hashCheckResultList`のオブジェクト数 |
| `hashCheckResultList` | Array | Required | 照会した Hashの検出結果: [hashCheckResultList](/docs/ja/security-filesafer-checkhash#hashCheckResultList) - リストにオブジェクトがある場合: マルウェア - リストにオブジェクトがない場合: 正常 |

#### `hashCheckResultList`

`hashCheckResultList`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `hashType` | String | Conditional | `hashCode`の作成に使用されたアルゴリズム - `sha1` \| `md5` - マルウェアとして検出された場合にのみ含む |
| `hashCode` | String | Conditional | マルウェアとして検出された Hash - マルウェアとして検出された場合にのみ含む |
| `group` | String | Conditional | マルウェアとして検出された Hash値のタイプ - `file` \| `url` - `file`: Hash値がファイルオブジェクトの場合 - `url`: Hash値が URLストリングの場合 - マルウェアとして検出された場合にのみ含む |
| `result` | String | Conditional | 照会した Hashがマルウェアとして検出されたかどうか - `1` - `1`: マルウェアとして検出 - マルウェアとして検出された場合にのみ含む |
| `regDatetime` | Long | Conditional | Hashが登録された時間 - マルウェアとして検出された場合にのみ含む |

### レスポンスステータスコード

File Safer APIで共通して使用されるレスポンスステータスコードの詳細は、[File Saferのレスポンスステータスコード](/docs/ja/security-filesafer#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

#### マルウェアが検出された場合

マルウェアが検出された場合、レスポンスのサンプルコードは次の通りです。

```
{
     "returnCode": "0",
     "returnMessage": "success",
     "totalRows": 1,
     "hashCheckResultList": [
        {
            "hashType": "sha1",
            "hashCode": "f093e7767bb63ac973b697d3fd1d40a78b87b8bf",
            "group": "file",
            "result": "1",
            "regDatetime": 1497409737000
         }
     ]
}
```

#### マルウェアが検出されなかった場合

マルウェアが検出されなかった場合、レスポンスのサンプルコードは次の通りです。

```
{
     "returnCode": "0",
     "returnMessage": "success",
     "totalRows": 0,
     "hashCheckResultList": [
     ]
}
```