File Safer

참고

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서][API 참조서]를 구분하여 제공하고 있습니다.

File Safer API 참조서 바로가기 >>
File Safer 설명서 바로가기 >>

개요

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

공통 설정

IAM 인증

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

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

API

Service API Method Request URI
Hash Filter checkHash GET https://filesafer.apigw.ntruss.com/hashfilter/v1/checkHash
File Filter inputFile POST https://filesafer.apigw.ntruss.com/filefilter/v1/inputFile
File Filter getInputFileLog GET https://filesafer.apigw.ntruss.com/filefilter/v1/getInputFileLog

요청 헤더

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

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

IAM 인증이 필요한 API 호출하기를 참조 합니다.

에러 코드

HTTP 응답 코드 returnCode returnMessage
200 0 success
200 140000 Unknown Error
200 140001 Parameter is invalid
200 140002 Not existent user
200 140003 Already in use
200 140004 Not allowed user
200 140005 Not existing the required parameter
200 140006 invalid request
200 140007 file size exceeds the limit
200 140009 Input file has a problem
200 140010 Unzip failed

공통 에러

HTTP 응답 코드 ErrorCode ErrorMessage
400 100 Bad Request Exception
401 200 Authentication Failed
401 210 Permission Denied
404 300 Not Found Exception
429 400 Quota Exceeded
429 410 Throttle Limited
429 420 Rate Limited
413 430 Request Entity Too Large
503 500 Endpoint Error
504 510 Endpoint Timeout
500 900 Unexpected Error

오퍼 레이션

아쉬운 점이 있다면 이야기해 주세요.
0/5000
내용을 입력해 주세요
의견 보내기