본 개발가이드는 링크허브에서 제공하는 휴폐업조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 휴폐업조회 API SDK를 통해 ‘개발환경 구성’ 방법을 상세히 안내드립니다.
-
Node.js V0.10.0 이상 최적화
-
Express V4.14.0 적용
-
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용
1. SDK 이용방법 안내
SDK를 이용하기 위해서는 API 상품 라이브러리 추가를 위한 ‘npm 모듈 설치’ 와 통신전문 보안에 사용되는 ‘인증정보 설정’ 이 필요합니다. 다음의 설명에 따라 SDK를 이용하시기 바랍니다.
npm 패키지 설치
예제 프로젝트에 팝빌 모듈을 추가하기 위해서 “package.json” 파일의 dependencies 항목에 다음의 코드가 추가되어 있는지 확인하고 SDK 샘플 프로젝트의 npm 패키지 설치를 진행합니다.
|
17 18 19 20 21 22 23 24 25 26 27 28 |
"dependencies": { "body-parser": "~1.13.2", "cookie-parser": "~1.3.5", "debug": "~2.2.0", "ejs": "~2.3.3", "express": "~4.13.1", "morgan": "~1.6.1", "serve-favicon": "~2.3.0", "closedown": "1.0.*" } |
|
1 2 3 |
$ npm install |
인증정보 설정
npm 모듈 설치 후, “/routes/closedown.js” 파일에 링크아이디(LinkID)와 비밀키(SecretKey)를 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
var express = require('express'); var router = express.Router(); var closedown = require('closedown'); closedown.config({ LinkID :'TESTER', //링크아이디 SecretKey : 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=', //비밀키 defaultErrorHandler : function(Error) { console.log('Error Occur : [' + Error.code + '] ' + Error.message); } }); // 휴폐업조회 API 모듈초기화 var closedownService = closedown.ClosedownChecker(); |
▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)
1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]
2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]
▼ [참고] 언어별 SDK 개발가이드
- Java – SpringMVC SDK 개발가이드
- Java – JSP SDK 개발가이드
- .NET SDK 개발가이드
- PHP SDK 개발가이드
- Python SDK 개발가이드
- ASP SDK 개발가이드
- Delphi SDK 개발가이드
- Visual Basic SDK 개발가이드
- VBA SDK 개발가이드
- PowerBuilder SDK 개발가이드
- Node.js SDK 개발가이드
휴폐업조회 서비스 이용절차에 대한 정보는 아래의 링크를 참조하시기 바랍니다.
고객님들의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락주시기 바랍니다.
링크허브 개발팀 정요한 과장 / T.1600-9854 / D. 070-4304-2991/ E. code@linkhub.co.kr