Java SDK(풀 샘플소스) JSP 개발환경 설정방법

[JAVA – JSP] SDK 적용방법

2018.07.04

본 개발가이드는 팝빌에서 제공하는 전자세금계산서 API, 전자명세서 API, 현금영수증 API, 문자 API, 팩스 API, 휴폐업조회 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 전자세금계산서 API 예제를 통해 ‘SDK 이용방법’과 ‘상업용 환경설정’ 방법을 상세히 안내드립니다.

Java JDK v1.6 최적화
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용

1. SDK 이용방법 안내

개발환경 구성을 위해서는 API 인증에 사용되는 ‘인증정보 설정’ 과정을 완료해야 정상적으로 링크허브 API 상품을 이용할 수 있습니다. 다음의 설명을 참조하여 개발환경 설정을 진행하시기 바랍니다.

인증정보 설정

SDK 샘플소스를 다운로드한 후 “common.jsp” 파일에 링크아이디(LinkID)와 비밀키(SecretKey) 값을 각각 링크허브 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정 완료됩니다.


<%@page errorPage="/exception.jsp" %>
<jsp:useBean id="taxinvoiceService" scope="application" 
class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>

<%-- 링크아이디 --%>
<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTER"/>

<%-- 발급받은 비밀키, 사용자 인증에 사용되는 정보이므로 유출에 주의 --%>
<jsp:setProperty name="taxinvoiceService" property="secretKey" 
value="kcZrgaTm8V8i3MisdunwWOHDTCjMq/+o/dyENejL+mo="/>

<%-- API요청 환경설정을 위한 설정값. true(테스트용), false(상업용)
     상업용으로 전환 시 false로 처리. --%>
<jsp:setProperty name="taxinvoiceService" property="test" value="true"/>

<%@page errorPage="/exception.jsp" %>

<jsp:useBean id="taxinvoiceService" scope="application"

class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>

<%-- 링크아이디 --%>

<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTER"/>

<%-- 발급받은 비밀키, 사용자 인증에 사용되는 정보이므로 유출에 주의 --%>

<jsp:setProperty name="taxinvoiceService" property="secretKey"

value="kcZrgaTm8V8i3MisdunwWOHDTCjMq/+o/dyENejL+mo="/>

<%-- API요청 환경설정을 위한 설정값. true(테스트용), false(상업용)

상업용으로 전환 시 false로 처리. --%>

<jsp:setProperty name="taxinvoiceService" property="test" value="true"/>

▼ [참고] 인증관련 에러별 트러블 슈팅(Trouble Shooting)

1. 에러코드 : -99010004, “유효한 요청 시간이 아닙니다.” [바로가기]
2. 에러코드 : -99010007, “권한요청 정보의 서명이 일치하지 않습니다.” [바로가기]

2. 상업용 환경설정

예제폴더에 포함되어 있는 “common.jsp” 파일의 test property의 value를 “false” 로 기재하면 상업용 연동환경 설정이 완료됩니다.


<%@page errorPage="/exception.jsp" %>
<jsp:useBean id="taxinvoiceService" scope="application" 
class="com.popbill.api.taxinvoice.TaxinvoiceServiceImp"/>

<%-- 연동아이디 --%>
<jsp:setProperty name="taxinvoiceService" property="linkID" value="TESTER"/>

<%-- 발급받은 비밀키, 사용자 인증에 사용되는 정보이므로 유출에 주의 --%>
<jsp:setProperty name="taxinvoiceService" property="secretKey" value="kcZrgaTm8V8i3MisdunwWOHDTCjMq/+o/dyENejL+mo="/>

<%-- API요청 환경설정을 위한 설정값. true(테스트용), false(상업용)
     상업용으로 전환 시 false로 처리. --%>
<jsp:setProperty name="taxinvoiceService" property="test" value="false"/>