getThresholdNotiConfig (Hash Filter, File Filter)
    • PDF

    getThresholdNotiConfig (Hash Filter, File Filter)

    • PDF

    기사 요약

    개요

    • getThresholdNotiConfig API 는 "File Safer"의 "Hash Filter"와 "File Filter"에서 제공하는 기능으로 결과 통보 설정 내 고급 설정(임계치 설정)의 설정 값을 확인하는 API입니다.
    • 해당 API는 네이버 클라우드 플랫폼[공공기관용]에서 사용하는 IAM인증 및 API Gateway를 통해 사용하실 수 있습니다.

    Hash Filter 요청

    MethodRequest URI
    POSThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/getThresholdNotiConfig

    File Filter 요청

    MethodRequest URI
    POSThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/getThresholdNotiConfig

    요청 헤더

    헤더명설명
    x-ncp-apigw-timestamp1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것
    API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-apigw-api-keyAPI Gateway에서 발급받은 키
    x-ncp-iam-access-key네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
    x-ncp-apigw-signature-v2요청 경로 및 헤더를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명으로
    HMAC 암호화 알고리즘은 HmacSHA256 사용
    acceptjson을 명시
    application/json

    응답

    응답 바디 (Hash Filter, File Filter 동일)

    필드명필수 여부타입설명
    returnCodeYesstring요청에 대한 처리 결과 코드
    returnMessageYesstring요청에 대한 처리 결과 메시지
    thresholdNotificationInfoListYesList- 분석 결과 통보 설정 값에 대한 정보
    - 리스트에 object가 있을 경우: 분석 결과 통보 설정
    - 리스트에 object가 없을 경우: 분석 결과 통보 미설정
    notificationTypeYesstring분석 결과 통보가 설정된 경우에만 포함
    분석 결과 통보 설정 값
    referenceTimeYesinteger분석 결과 통보가 설정된 경우에만 포함
    - 시간 설정(분) 값
    5분 단위로 5~30 까지 설정할 수 있음
    thresholdValueYesinteger분석 결과 통보가 설정된 경우에만 포함
    - 임계치 설정 값
    임계치는 1~1000 값으로 설정 가능

    예시

    Hash Filter 결과 통보 설정 요청 예시

    curl -X POST "https://filesafer.apigw.gov-ntruss.com/hashfilter/v1/getThresholdNotiConfig"
       -H "accept: application/json"
       -H "x-ncp-apigw-api-key: {x-ncp-apigw-api-key}"
       -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"
       -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}"
       -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
    

    File Filter 결과 통보 설정 요청 예시

    curl -X POST "https://filesafer.apigw.gov-ntruss.com/filefilter/v1/getThresholdNotiConfig"
       -H "accept: application/json"
       -H "x-ncp-apigw-api-key: {x-ncp-apigw-api-key}"
       -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"
       -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}"
       -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
    

    응답 예시

    {
      "returnCode": "0",
      "returnMessage": "success",
      "thresholdNotificationInfoList": [
        "notificationType": "MAL",
        "referenceTime": 5,
        "thresholdValue": 1
      ]
    }
    

    이 문서가 도움이 되었습니까?

    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.