File Safer 개요
    • PDF

    File Safer 개요

    • PDF

    기사 요약

    File Safer API는 RETSTful 형태로 제공되며, 제공되는 API를 호출하기 위해서는 API Gateway의 IAM 인증을 수행해야 합니다.

    공통 설정

    IAM 인증

    File Safer의 API는 API Gateway를 통해 제공되므로 API Gateway이용 시 필요한 IAM 인증을 위해 이용 신청 및 API Key가 필요합니다.

    아래의 가이드를 참조하여 API Gateway의 이용을 신청합니다.

    API Gateway의 API Keys 메뉴로 이동하여 API Key를 생성 합니다.

    File Safer의 API의 Subscription Type은 공개-자율구독(Public)이므로 별도의 구독과정없이 생성하신 API Key를 이용하여 사용 가능합니다.

    API URL

    ServiceAPI메서드Request URI
    Hash FiltercheckHashGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/checkHash
    Hash FiltergetNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/getNotiConfig
    Hash FiltersetNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/setNotiConfig
    Hash FiltergetThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/getThresholdNotiConfig
    Hash FiltersetThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/setThresholdNotiConfig
    Hash FilterremoveThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/hashfilter/v1/removeThresholdNotiConfig
    File FilterinputFilePOSThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/inputFile
    File FiltergetInputFileLogGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/getInputFileLog
    File FiltergetNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/getNotiConfig
    File FiltersetNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/setNotiConfig
    File FiltergetThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/getThresholdNotiConfig
    File FiltersetThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/setThresholdNotiConfig
    File FilterremoveThresholdNotiConfigGEThttps://filesafer.apigw.gov-ntruss.com/filefilter/v1/removeThresholdNotiConfig

    요청 헤더

    IAM 인증을 위한 요청 헤더 입니다.

    헤더 명설명
    x-ncp-apigw-timestamp1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(millisecond)로 나타낸 것입니다.
    APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-apigw-api-keyAPI Gateway에서 발급받은 키
    x-ncp-iam-access-keyNCP에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
    x-ncp-apigw-signature-v2Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명
    HMAC 암호화 알고리즘은 HmacSHA256 사용

    에러 코드

    HTTP 응답 코드returnCodereturnMessage
    2000success
    200140000Unknown Error
    200140001Parameter is invalid
    200140002Not existent user
    200140003Already in use
    200140004Not allowed user
    200140005Not existing the required parameter
    200140006invalid request
    200140007file size exceeds the limit
    200140009Input file has a problem
    200140010Unzip failed

    공통 에러

    HTTP 응답 코드ErrorCodeErrorMessage
    400100Bad Request Exception
    401200Authentication Failed
    401210Permission Denied
    404300Not Found Exception
    429400Quota Exceeded
    429410Throttle Limited
    429420Rate Limited
    413430Request Entity Too Large
    503500Endpoint Error
    504510Endpoint Timeout
    500900Unexpected Error

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

    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.