자주하는 질문
API 를 테스트하고 싶습니다. 테스트에 필요한 절차가 어떻게 되나요?
팝빌 API 서비스를 테스트하기 위해서는 우선적으로 서비스 연동신청이 필요합니다. 연동신청 승인 이후 담당자의 메일로 송부된 인증정보를 통해 SDK Example 코드를 테스트할 수 있습니다.
API 를 직접 구현해야 하나요?
팝빌의 모든 서비스는 API로 구현한 언어별 SDK로 지원되며, 개발 과정에서 사전에 정의된 언어별 SDK의 함수 호출하는 방식을 이용하여 쉽게 기능을 구현할 수 있습니다. 현재 Java, PHP, .Net, Node.js, Python, ASP, Delphi, PowerBuilder, Visual Basic6, VBA, Ruby, SAP ERP를 지원하고 있습니다.
- 팝빌 연동자료실 https://www.popbill.com/Content/SDK
API 호출에 대한 사용횟수 또는 동시처리에 대한 제한이 있나요?
API 호출에 대한 사용횟수 또는 동시처리에 대한 제한은 없습니다. 다만 서버에 부하를 발생시키는 의도적인 공격에 대해서는 모니터링을 통해 IP를 제한하고 있습니다.
API 를 통해 주고받는 요청/응답 전문은 암호화 되나요?
모든 팝빌 API 서비스는 TLS 암호화 통신을 기반으로 HMAC-SHA1 알고리즘이 적용되어 있습니다. 또한 네트워크 스니핑(Sniffing)/스푸핑(Spoofing) 등 제 3자가 의도적으로 네트워크 패킷을 획득/변조 하더라도 보안에 문제가 발생하지 않도록 OAuth 기반의 링크허브 인증, Bearer Token 인증이 팝빌 서버에 적용되어 있습니다.
호스팅 서버를 사용하고 있습니다. 팝빌 API를 이용할 수 있나요?
팝빌 API는 HTTP 통신이 가능한 모든 환경에서 이용 가능합니다. 팝빌에서 제공되는 SDK는 개발언어 자체의 HTTP 내장함수가 구현되어 별도의 모듈이나 라이브러리 설치 없이도 함수 기능을 이용할 수 있습니다. 호스팅 서버의 보안정책상 아웃바운드 트래픽을 제한하는 서버환경에서도 팝빌 API 서버 IP를 화이트리스트에 등록하시면 문제없이 SDK를 이용할 수 있습니다.
모바일 어플리케이션을 개발하고 있습니다. 전자명세서 기능을 구현할 수 있나요?
모바일 어플리케이션을 개발하는 경우 고객사에서 팝빌 전자명세서 API 기능을 처리할 별도의 서버를 구축하고 모바일 어플리케이션을 통해 작성된 세금계산서 정보를 서버로 전송하는 방식으로 구현할 수 있습니다.
SDK 사용에 대한 기술지원을 받고 싶습니다. 어떤 방법이 있나요?
팝빌 기술지원센터에서는 각 언어별 전담 개발자들이 유선/메일/원격지원을 통해 연동개발을 지원하고 있습니다.
브라우저에서 URL을 호출하거나 Postman과 같이 HTTP Request를 호출해 테스트 할 수 없나요?
팝빌 API 서비스는 인증 및 토큰 발급 과정이 필요하기 때문에, 단순한 HTTP Request 호출로 테스트를 진행할 수 없습니다. 인증 및 토큰 발급 과정은 지원하는 언어의 SDK에 구현되어 있기 때문에 별도의 구현과정은 필요 없습니다.
도입을 검토중입니다. SDK를 사용할 때 비용을 지불하나요?
팝빌에서는 개발환경에서 테스트를 통해 발생하는 비용을 포인트를 통해 무료로 지원하고 있습니다.
지원된 포인트를 모두 소진하였을 경우 상황에 따라 충전처리가 필요할 수 있습니다.
외부 네트워크와 차단된 내부망 환경입니다. API를 연동할 수 있나요?
외부 네트워크와 차단된 내부망 환경에서는 외부 연결이 가능한 DMZ존에 Proxy 서버를 세팅하여 API를 호출할 수 있습니다. 실제 Proxy 환경을 구현한 파트너사의 사례가 많고, Proxy 구축 가이드 문서와 함께 기술지원센터의 개발지원을 받아 연동을 진행 할 수 있습니다.
SDK 함수 호출시 "링크아이디에 사용 가능한 아이피주소가 아닙니다." 오류가 발생합니다.
해당 오류는 연동신청 승인 후 메일로 발급해드린 인증정보(링크아이디, 비밀키)를 SDK 예제코드에서 변경하지 않고 SDK 예제코드의 함수를 호출하였을 때 발생합니다. 인증정보에 대한 변수값을 변경하였는지 확인하고, 서버환경이라면 서버 애플리케이션에 적용을 위해 재시작 또는 리로드해주시기 바랍니다.
SDK 함수 호출시 "인증키와 사용자아이디로 사용자를 식별할 수 없습니다." 오류가 발생합니다.
해당 오류는 함수 파라미터로 기재된 '팝빌회원 아이디'가 올바르지 않은 경우에 발생합니다. 함수 호출시 기재된 팝빌회원 아이디가 회원가입시 기재한 정보와 일치하는지, 또는 파트너 신청시 메일로 발급해드린 인증정보에 포함된 '링크아이디' 를 '팝빌회원 아이디'에 기재하지 않았는지 확인 하시기 바랍니다.
SDK 호출을 통해 테스트한 전자명세서는 어디서 확인할 수 있나요?
SDK를 통해 발행한 전자명세서는 팝빌 개발환경 사이트에서 확인할 수 있습니다. 개발환경 사이트에 로그인하여 상단의 [전자명세서] 메뉴를 선택하시면 전자명세서 상태에 따른 문서함에서 테스트한 전자명세서 정보를 확인할 수 있습니다.
- 팝빌 개발환경 https://test.popbill.com
전자명세서의 메일, 문자, 팩스 전송 기능 이용시 포인트가 차감되나요?
팝빌 서비스에서 메일 전송 기능은 포인트가 소진되지 않습니다. 하지만 문자, 팩스 기능은 사용 건수에 따라 포인트 차감이 차감됩니다.
전자명세서 뿐만 아니라 다른 서비스도 테스트하고 싶습니다 어떻게 해야 하나요?
전자명세서 API 연동을 이미 진행하셨다면, 유사한 함수 패턴과 로직으로 구현된 SDK를 통해 팝빌의 다른 서비스 테스트 및 기능 구현이 보다 수월합니다. 테스트에 앞서 API 서비스 이용을 위한 사전설정이 필요하므로 파트너센터로 연락주시기 바랍니다.
팝빌 파트너센터 :1600-8536sales@linkhub.co.kr
전자명세서 기능 개발을 완료하였습니다. 상업용 전환은 어떻게 진행하나요?
상업용 전환은 파트너센터에서 진행을 도와드리고 있습니다. 아래의 연락처로 연락주시기 바랍니다.
팝빌 파트너센터 :1600-8536sales@linkhub.co.kr
팝빌 SDK를 업데이트 하더라도 기존에 구현한 함수는 영향이 없나요?
팝빌 API 서비스의 언어별 SDK는 github을 통해 공개되어 있으며, 버전관리 및 하위호환성을 보장하고 있습니다. 공개된 자료는 아래의 github 링크를 참조하시기 바랍니다.
- 팝빌 SDK Github https://github.com/linkhub-sdk/