nShortURL 개요

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

웹 페이지의 링크 정보는 매우 긴 경우가 많습니다. nShortURL 서비스는 긴 URL을 짧은 형태로 줄여주어 글자 수에 제한이 있는 SMS를 전송하거나 SNS를 이용할 때 부담을 줄일 수 있습니다. 보안 이슈나 유해성이 필터링된 URL만 생성할 수 있는 구조이므로 안심하고 이용하세요.

공통 설정

클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.

콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 nShortURL가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API URL

메서드	인증	요청 URL	출력 포맷
GET / POST	-	`https://naveropenapi.apigw.gov-ntruss.com/util/v1/shorturl`	JSON

요청 헤더

헤더 명	설명
X-NCP-APIGW-API-KEY-ID	앱 등록 시 발급받은 Client ID `X-NCP-APIGW-API-KEY-ID:{Client ID}`
X-NCP-APIGW-API-KEY	앱 등록 시 발급 받은 Client Secret `X-NCP-APIGW-API-KEY:{Client Secret}`

에러 코드

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

공통 에러

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) 등 request 에러
401	200	Authentication Failed	인증실패
401	210	Permission Denied	권한없음
404	300	Not Found Exception	권한없음
429	400	Quota Exceeded	Quota 초과
429	410	Throttle Limited	Rate 초과
429	420	Rate Limited	Rate 초과
413	430	Request Entity Too Large	conent-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결에러
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 에러

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

What's Next

shorturl

공통 설정

태그