본문으로 바로가기
링크허브 공식블로그

연동이 쉬워진다

링크허브 공식블로그

가치를 연결하다/튜토리얼

[C#.NET] 팝빌 휴폐업조회 API 연동 가이드

안녕하세요. 고객의 가치를 연결하는 비즈니스 파트너 링크허브 입니다. 


본 포스팅에서는 C#.NET 개발환경에서 고객사들이 팝빌 휴폐업조회 API SDK를 쉽고 빠르게 이용할 수 있도록, 예시를 통하여 연동 설정 방법을 안내드리겠습니다. 신규프로젝트 생성과 SDK 추가 후, "단건조회(CheckCorpNum) API"를 구현하는 순서로 진행하겠습니다. 

링크허브 SDK는 .NET Framework V2.x 이상 모든 개발환경을 지원하며, 통신을 위한 별도 프로그램 설치가 필요하지 않습니다. 


"팝빌은 링크허브에서 자체 개발하고 직접 운영하는 휴폐업조회 서비스 Brand Name 입니다."



아래 설명하는 개발환경은 [.NET Framework 3.5 | MS Visual Studio 2008 ] 기준으로 작성되어 있어, 이용 중인 개발환경과 차이가 있을 수 있는 점 감안해 주시기 바랍니다.


1. 프로젝트 생성


비주얼 스튜디오에서 [파일 > 새로 만들기 > 프로젝트] 메뉴를 선택하여 휴폐업조회 SDK 추가를 위한 새 프로젝트를 생성합니다.

 - 템플릿 : Windows Forms 응용 프로그램

 - (프로젝트) 이름 : Tutorial_Example

 - 위치 : C:\

 - 솔루션 이름 : Tutorial




2. 휴폐업조회 SDK 추가


① 링크허브 연동자료실에서 C#.NET 휴폐업조회 SDK를 다운로드 후 압축을 해제합니다. 


[참고] C#.NET 휴폐업조회 SDK 다운로드 - https://www.linkhub.co.kr/Downloads/Closedown/201?PageNum=1 



② "C:\Tutorial\" 경로에 "PopbillSDK" 명으로 새 폴더를 생성하고, SDK에서 휴폐업조회 연동에 필요한 Linkhub, Popbill 두개의 폴더를 복사합니다.



③ [파일 > 추가 > 기존 프로젝트] 메뉴를 선택 후 PopbillSDK 폴더 안에 있는 Linkhub.csproj, Popbill.csproj를 각각 추가합니다. 



④ Tutorial_Example 프로젝트에 Popbill 프로젝트를 참조 추가 합니다.



 Form1.cs 파일에 인증정보(LinkID, SecretKey)와 휴폐업조회 객체를 선언합니다.


namespace Popbill.Closedown
{
    public partial class Form1 : Form
    {

        // 링크허브에서 발급받은 인증정보 링크아이디(LinkID), 비밀키(SecretKey)입력.

        // 인증정보는 파트너 식별 및  API 텅신전문 변조를 방지하는 기능을 수행하므로
        // 외부에 유출되지 않도록 각별히 유의하여 관리해 주시기 바랍니다.
        private string LinkID = "OOOOOOOOO";
        private string SecretKey = "OOOOOOOOOOOOOOOOO";

        // 휴폐업조회 서비스 객체 선언
        private ClosedownService closedownService;
    }
}

▶ 링크허브에서 발급받은 고객사 인증정보로 링크아이디(LinkID)와 비밀키(SecretKey) 값을 변경하시기 바랍니다.



 Form1 생성자에 휴폐업조회 서비스 객체를 초기화하고, 연동환경 설정값(IsTest)을 선언합니다.


public Form1()
{
      InitializeComponent();

      // 휴폐업조회 서비스 객체 초기화
      closedownService = new ClosedownService(LinkID, SecretKey);
// 연동환경 설정값, true - 개발용(테스트베드), false - 상업용(실서비스) closedownService.IsTest = true;
}



API 호출 시점에 인증서버로부터 발급받은 토큰을 이용해 사용자를 인증하며, 발급된 토큰은 30분의 유효시간 내에서는 재사용이 가능합니다. 
만약, 휴폐업조회 서비스 객체를 지역변수로 선언하거나 API 호출시 마다 객체를 초기화 시키면 매번 토큰을 재발급 받는 과정을 거쳐야 하기 때문에 성능 저하 및 리소스 낭비의 요인이 됩니다.




3. API 구현


① CheckCorpNum API를 호출하기 위해 Form1.cs에 버튼(btnCheckCorpNum)을 생성합니다.



② btnCheckCorpNum Click 이벤트에 휴폐업 단건조회 확인을 위해 checkCorpNum API를 작성합니다.




③ 휴폐업조회 처리결과를 응답 메시지를 통해 확인합니다. 

[참고] "권한정보의 서명이 일치하지 않습니다." 오류메시지 해결방법 안내 - https://linkhub.tistory.com/98



④ 휴폐업조회 내역은 팝빌 개발용(test.popbill.com) 사이트에서 확인할 수 있습니다.

[참고] 팝빌 연동 개발을 위한 테스트베드(개발용) 안내 - https://linkhub.tistory.com/91



팝빌에서 제공하는 다양한 API는 동일한 컨셉으로 개발되어 있어, 하나의 서비스를 이용한 경험이 있으면 다른 서비스들도 유사한 방법으로 빠르게 연동이 가능하니 많은 이용 부탁드립니다. 


지금까지 C#.NET 개발환경에서 휴폐업조회 API를 연동하는 방법에 대해 안내해 드렸는데, 내용에 대한 추가적인 문의가 있으면 기술지원센터로 편하게 연락 주시기 바랍니다.



고객사의 편의를 위하여 이메일, 전화 등 다양한 채널을 열어놓고 있으니 언제든지 연락 주시기 바랍니다.

기술지원센터 / T. 1600-9854 / E. code@linkhub.co.kr






  • Today
  • Total