Overview

CODEF는 온라인에 흩어진 데이터를 클라이언트 엔진과 웹 API 등을 활용해 쉽고 빠르게 사용할 수 있도록 돕습니다. 아이디어가 구현되기 위한 복잡한 과정을 간결하게 바꾸고, 수고로움을 줄이고자 노력합니다.

홈페이지
개발가이드
블로그

easycodef-java는 CODEF API 연동 개발을 돕는 라이브러리 유틸입니다. 사용을 위해서는 홈페이지 가입 후 데모/정식 서비스 신청을 통해 자격 증명을 위한 클라이언트 정보 등을 발급받아야 하며 사용 가능한 모든 API의 엔드포인트(은행, 카드, 보험, 증권, 공공, 기타)와 요청/응답 항목은 모두 개발가이드를 통해 확인할 수 있습니다.

Get it!

Dependency

라이브러리는 Maven 중앙 저장소에서 확인 가능한 io.codef.api 패키지에 속해 있으며 의존관계 설정을 통해 사용 가능합니다.

• Maven

<dependencies>
  ...
  <!-- 가급적 최신 버전 사용 권장 -->
  <dependency>
    <groupId>io.codef.api</groupId>
    <artifactId>easycodef-java</artifactId>
    <version>1.0.6</version>
  </dependency>
  ...
</dependencies>

• Gradle

  implementation 'io.codef.api:easycodef-java:1.0.6'

Non-Maven dependency resolution

메이븐 중앙 저장소에서 모든 버전의 easycodef-java jar 파일을 다운로드할 수 있습니다.

Use it!

1. 토큰 요청

CODEF API 서비스를 이용하기 위해서는 서비스 이용에 대한 자격 증명을 통해 토큰을 발급받아야 합니다. 토큰은 모든 요청시 헤더 값에 포함되어야 하며 한번 발급 받은 토큰은 일주일간 재사용이 가능합니다.

easycodef-java 라이브러리는 토큰의 발급과 재사용을 자동으로 처리합니다.
재사용 중인 토큰의 유효기간이 만료되는 경우 재발급 또한 자동으로 처리됩니다.

사용자는 단순히 자격증명을 위한 클라이언트 정보 설정 만을 진행하면 됩니다. 아래의 예제는 사용자가 직접 토큰을 발급받는 과정을 설명합니다. 계정 관리나 상품 요청시 토큰은 라이브러리 내에서 자동 발급받아 사용하기 때문에 특별한 경우가 아니라면 사용자가 직접 토큰을 요청할 필요는 없습니다.

// #1.쉬운 코드에프 객체 생성
EasyCodef codef = new EasyCodef();

/** #2.데모 클라이언트 정보 설정
* - 데모 서비스 가입 후 코드에프 홈페이지에 확인 가능(https://codef.io/#/account/keys)
* - 데모 서비스로 상품 조회 요청시 필수 입력 항목	*/
codef.setClientInfoForDemo(EasyCodefClientInfo.DEMO_CLIENT_ID, EasyCodefClientInfo.DEMO_CLIENT_SECRET);

/** #3.정식 클라이언트 정보 설정
* - 정식 서비스 가입 후 코드에프 홈페이지에 확인 가능(https://codef.io/#/account/keys)
* - 정식 서비스로 상품 조회 요청시 필수 입력 항목 */
codef.setClientInfo(EasyCodefClientInfo.CLIENT_ID, EasyCodefClientInfo.CLIENT_SECRET);

/** #4.RSA암호화를 위한 퍼블릭키 설정
* - 데모/정식 서비스 가입 후 코드에프 홈페이지에 확인 가능(https://codef.io/#/account/keys)
* - 암호화가 필요한 필드에 사용 (ex)encryptValue(String plainText); */
codef.setPublicKey(EasyCodefClientInfo.PUBLIC_KEY);

/** #5.코드에프 토큰 발급 요청 - 서비스타입(API:정식, DEMO:데모, SANDBOX:샌드박스) */
String accessToken1 = codef.requestToken(EasyCodefServiceType.SANDBOX);	// 토큰 요청1 (requestToken)
System.out.println(accessToken1);
		
String accessToken2 = codef.requestToken(EasyCodefServiceType.SANDBOX);	// 토큰 요청2 (requestToken)
System.out.println(accessToken2);
		
assertEquals("성능 향상을 위한 재사용 토큰 이용 확인", accessToken1, accessToken2);
		
String accessToken3 = codef.requestNewToken(EasyCodefServiceType.SANDBOX);// 신규 토큰 요청1 (requestNewToken)
System.out.println(accessToken3);
	
String accessToken4 = codef.requestNewToken(EasyCodefServiceType.SANDBOX);// 신규 토큰 요청2 (requestNewToken)
System.out.println(accessToken4);
	
assertNotEquals("토큰 권한 변경 등에 따라 필요한 신규 토큰 발급 확인", accessToken3, accessToken4);

2. 계정 관리

CODEF API 서비스의 여러 상품들 중 요청 파라미터에 Connected ID가 필요한 경우가 있습니다. 인증이 필요한 CODEF API를 사용하기 위해서는 엔드 유저(End User) 계정 정보(대상기관의 인증수단)등록이 필요하며, 이를 통해 사용자마다 다른 Connected ID를 발급받을 수 있습니다. (Connected ID는 개발가이드 인증방식에서 자세한 내용을 확인하세요.)

Connected ID 발급 이후에는 직접적인 계정 정보 전송 없이 대상기관의 데이터를 요청할 수 있습니다. Connected ID는 계정 등록 요청 시 발급되며 이후 계정 추가/계정 수정/계정 삭제 요청으로 관리할 수 있습니다. 동일한 기관의 동일한 계정 정보는 중복해서 등록할 수 없으며 개인 고객/기업 고객 각각 1개씩 등록이 가능합니다.

모든 상품의 파라미터에 Connected ID가 필요한 것은 아닙니다. 상품별 파라미터는 개발가이드 상품안내에서 확인할 수 있습니다.

Connected ID를 사용하지 않는 API를 사용하는 경우 계정 관리는 생략하세요.

// 쉬운 코드에프 객체 생성 및 클라이언트 정보, 퍼블릭키 설정에 관한 #1~#4 단계는 생략.

/**	
 * #5.요청 파라미터 설정
 * - 계정관리 파라미터를 설정(https://developer.codef.io/cert/account/cid-overview)	
 */
List<HashMap<String, Object>>  accountList = new ArrayList<HashMap<String, Object>> ();
HashMap<String, Object> accountMap = new HashMap<String, Object>();
accountMap.put("countryCode",	"KR");
accountMap.put("businessType",	"CD");
accountMap.put("clientType", 	"P");
accountMap.put("organization",	"0309"); // 기관코드는 각 상품 페이지에서 확인 가능
accountMap.put("loginType",  	"1");
accountMap.put("id",  		"user_id");

try {
	accountMap.put("password",  EasyCodefUtil.encryptRSA("user_password", codef.getPublicKey())); // RSA암호화가 필요한 필드는 encryptRSA(String plainText, String publicKey) 메서드를 이용해 암호화
} catch (Exception e) {
	e.printStackTrace();
	return;
}
accountList.add(accountMap);

HashMap<String, Object> parameterMap = new HashMap<String, Object> ();
parameterMap.put("accountList", accountList);

/** #6.계정 등록 요청(Connected ID 발급 요청)	- 서비스타입(API:정식, DEMO:데모, SANDBOX:샌드박스) */
String result = codef.createAccount(EasyCodefServiceType.SANDBOX, parameterMap);

/** #7.결과 확인	*/
System.out.println(result);

계정 등록 요청은 등록하려는 여러 기관의 계정을 목록 파라미터로 설정해 한번에 요청이 가능하며 응답 결과는 아래와 같습니다. 사용자는 발급받은 Connected ID를 계정 등록에 성공한 기관(successList) 상품 조회 요청시 사용을 할 수 있습니다.

예) 우리카드(0309)으로 등록한 Connected ID를 KB카드(0301) 상품 조회시 사용할 수 없음

{
  "result" : {
    "code" : "CF-00000",
    "extraMessage" : "",
    "message" : "정상",
    "transactionId":"786e01e459af491888e1f782d1902e40"
  },
  "data" : {
    "successList" : [ {
      "code" : "CF-00000",    
      "message" : "정상",
      "extraMessage" : "",            
      "countryCode" : "KR",      
      "businessType" : "CD",      
      "clientType" : "P",
      "loginType" : "1",
      "organization" : "0309"
    }],
    "errorList" : [ ],
    "connectedId" : "byi1wYwD40k8hEIiXl6bRF"
  }
}

계정 등록 이외의 계정 추가, 수정, 삭제 등의 계정 관리 기능과 계정 목록 조회, Connected ID 목록 조회 등 조회 기능은 계정관리 테스트 패키지에서 확인 할 수 있습니다. 테스트 패키지의 모든 테스트 케이스는 샌드박스 서버를 대상으로 즉시 테스트가 가능합니다.

샌드박스에서는 필수 요청 파라미터 여부를 체크한 뒤 요청 상품에 따른 예정되어 있는 고정 응답 값을 반환합니다.
사용자는 샌드박스를 통해 코드에프 연동에 대한 개발 연습과 상품 별 응답 자료 구조 등을 확인 할 수 있습니다.

인증서로 계정을 등록하는 경우에는 cert파일, key파일 세트 혹은 pfx파일 2가지 모두를 지원합니다. 개발가이드 계정등록에서 자세한 내용을 확인하세요. 인증서 내보내기/가져오기 등 인증서 릴레이 서버 기능이 필요한 경우 support@codef.io로 문의해주시기 바랍니다. 코드에프에서는 계정 관리를 위한 인증서 팝업과 전송 서버를 서비스 하고 있습니다.

3. 상품 요청

엔드 유저의 계정 등록 과정을 거쳐 상품 사용 준비가 끝났다면 이제 발급받은 Connected ID와 필요한 파라미터 정보 설정 등을 통해 코드에프 API 상품 요청을 할 수 있습니다. Connected ID를 사용하는 상품과 Connected ID를 사용하지 않는 상품 요청 예제를 아래 코드를 통해 확인하겠습니다.

한번 더 강조하자면 모든 상품의 파라미터에 Connected ID가 필요한 것은 아닙니다.
상품별 파라미터는 개발가이드 상품안내에서 확인할 수 있습니다.

- 일반 상품

// 개인 보유카드 조회(Connected ID 사용)

/** #1.쉬운 코드에프 객체 생성 및 클라이언트 정보 설정 */
EasyCodef codef = new EasyCodef();
codef.setClientInfoForDemo(EasyCodefClientInfo.DEMO_CLIENT_ID, EasyCodefClientInfo.DEMO_CLIENT_SECRET);
codef.setClientInfo(EasyCodefClientInfo.CLIENT_ID, EasyCodefClientInfo.CLIENT_SECRET);
codef.setPublicKey(EasyCodefClientInfo.PUBLIC_KEY);



/** #5.요청 파라미터 설정 - 각 상품별 파라미터를 설정(https://developer.codef.io/products) */
HashMap<String, Object> parameterMap = new HashMap<String, Object>();
parameterMap.put("connectedId", "sandbox_connectedId_01");
parameterMap.put("organization", "0309");
parameterMap.put("birthDate", "");	
parameterMap.put("inquiryType", "0");	

/** #6.코드에프 정보 조회 요청 - 서비스타입(API:정식, DEMO:데모, SANDBOX:샌드박스) */
String productUrl = "/v1/kr/card/p/account/card-list";	// (예시)개인 보유카드 조회 URL
String result = codef.requestProduct(productUrl, EasyCodefServiceType.SANDBOX, parameterMap);



/**	#7.코드에프 정보 결과 확인	*/
System.out.println(result);

HashMap<String, Object> responseMap = new ObjectMapper().readValue(result, HashMap.class);
HashMap<String, Object> resultMap = (HashMap<String, Object>)responseMap.get("result");

assertEquals("코드에프 상품 요청 결과 실패(반환된 코드와 메시지 확인 필요)", "CF-00000", (String)resultMap.get("code"));

쉬운 코드에프 객체 생성 후 클라이언트 정보 등을 설정한 다음 개인 보유카드 조회를 위한 파라미터를 설정해서 상품 요청을 합니다. 라이브러리 사용자는 토큰 발급이나 토큰 관리, 요청 파라미터의 인코딩, 응답 바디의 디코딩 등 API이용을 위한 부수적인 작업을 직접 할 필요가 없습니다. 상품 요청에 필요한 파라미터를 설정하고 requestProduct 메서드 호출만으로 Connected ID로 등록된 계정의 기관(0309 우리카드)의 보유카드 목록을 아래와 같이 응답받게 됩니다.

{
  "result" : {
    "code" : "CF-00000",
    "extraMessage" : "",
    "message" : "성공",
    "transactionId" : "5069429e367745baba92f5c12c4343de"
  },
  "data" : [ {
    "resCardType" : "체크/본인",
    "resValidPeriod" : "",
    "resCardName" : "OO체크카드-국제ATM",
    "resTrafficYN" : "불가능",
    "resIssueDate" : "",
    "resUserNm" : "***",
    "resSleepYN" : "",
    "resCardNo" : "6056********0000"
  }, {
    "resCardType" : "신용/본인",
    "resValidPeriod" : "",
    "resCardName" : "할인카드",
    "resTrafficYN" : "불가능",
    "resIssueDate" : "",
    "resUserNm" : "***",
    "resSleepYN" : "",
    "resCardNo" : "6253********0000"
  }, {
    "resCardType" : "체크/본인",
    "resValidPeriod" : "",
    "resCardName" : "OO체크카드",
    "resTrafficYN" : "불가능",
    "resIssueDate" : "",
    "resUserNm" : "***",
    "resSleepYN" : "",
    "resCardNo" : "4214********0000"
  } ]
}

이번에는 사업자 휴폐업 상태 정보를 조회하는 상품의 예제입니다.

// 사업자등록상태(휴폐업조회)(Connected ID 미사용)

/** #1.쉬운 코드에프 객체 생성 및 클라이언트 정보 설정 */
EasyCodef codef = new EasyCodef();
codef.setClientInfoForDemo(EasyCodefClientInfo.DEMO_CLIENT_ID, EasyCodefClientInfo.DEMO_CLIENT_SECRET);
codef.setClientInfo(EasyCodefClientInfo.CLIENT_ID, EasyCodefClientInfo.CLIENT_SECRET);
codef.setPublicKey(EasyCodefClientInfo.PUBLIC_KEY);



/** #5.요청 파라미터 설정 - 각 상품별 파라미터를 설정(https://developer.codef.io/products) */
HashMap<String, Object> parameterMap = **new** HashMap<String, Object>();
parameterMap.put("organization", "0004"); // 기관코드 설정

List<HashMap<String, String>> reqIdentityList = **new** ArrayList<HashMap<String, String>>();
HashMap<String, String> reqIdentityMap1 = **new** HashMap<String, String>();
reqIdentityMap1.put("reqIdentity", "3333344444");
reqIdentityList.add(reqIdentityMap1);

HashMap<String, String> reqIdentityMap2 = **new** HashMap<String, String>();
reqIdentityMap2.put("reqIdentity", "1234567890");
reqIdentityList.add(reqIdentityMap2);
parameterMap.put("reqIdentityList", reqIdentityList);

/** #6.코드에프 정보 조회 요청 - 서비스타입(API:정식, DEMO:데모, SANDBOX:샌드박스) */
String productUrl = "/v1/kr/public/nt/business/status"; // (예시)사업자등록상태(휴폐업조회) URL
String result = codef.requestProduct(productUrl, EasyCodefServiceType.SANDBOX, parameterMap);



/**	#7.코드에프 정보 결과 확인	*/
System.out.println(result);

HashMap<String, Object> responseMap = new ObjectMapper().readValue(result, HashMap.class);
HashMap<String, Object> resultMap = (HashMap<String, Object>)responseMap.get("result");

assertEquals("코드에프 상품 요청 결과 실패(반환된 코드와 메시지 확인 필요)", "CF-00000", (String)resultMap.get("code"));

2개의 상폼 요청 예시를 비교해 코드의 내용을 살펴보면 개인 보유카드 조회와 사업자등록상태 조회의 차이는 요청주소(URL)와 파라미터 설정에만 있는 것을 확인할 수 있습니다. 사용자는 라이브러리 사용을 통해 일관된 형태의 코드를 작성하여 개발할 수 있고 다른 사람이 작성한 상품 요청 코드를 쉽게 이해할 수 있습니다.

{
  "result" : {
    "code" : "CF-00000",
    "extraMessage" : "",
    "message" : "성공",
    "transactionId" : "786e01e459af491888e1f782d1902e40"
  },
  "data" : [ {
    "resBusinessStatus" : "사업을하지않고있습니다.",
    "resCompanyIdentityNo" : "3333344444",
    "code" : "CF-00000",
    "resTaxationTypeCode" : "98",
    "extraMessage" : null,
    "resClosingDate" : "",
    "resTransferTaxTypeDate" : "",
    "message" : "성공"
  }, {
    "resBusinessStatus" : "부가가치세일반과세자입니다.\n*과세유형전환된날짜는2011년07월01일입니다.",
    "resCompanyIdentityNo" : "1234567890",
    "code" : "CF-00000",
    "resTaxationTypeCode" : "1",
    "extraMessage" : null,
    "resClosingDate" : "",
    "resTransferTaxTypeDate" : "20110701",
    "message" : "성공"
  } ]
}

- 추가 인증 상품

추가 인증 상품이란 API호출 한번으로 요청 결과를 받을 수 있는 일반 상품과는 달리 첫 요청 이후 대상기관이 요구하는 추가 인증(이메일, SMS, 보안문자 입력 등)을 수행해야 요청 결과를 받을 수 있는 상품을 의미합니다.

예를 들어 아래 그림과 같이 로그인을 하는 경우 아이디와 비밀번호 외에 대상기관에서 추가적으로 요구하는 보안문자 입력이 진행되어야 합니다. 고정 값인 아이디, 비밀번호와 다르게 보안문자 이미지는 랜덤하게 반환되기 때문에 엔드 유저의 추가적인 정보 입력이 필요합니다.

대상기관이 요구하는 인증방식에 따라 N차 추가인증이 요구 될 수 있으며, 추가 인증 정보 입력이 진행되어야 정상적으로 CODEF API 요청도 완료됩니다. 1차 입력부[기본파라미터] -> n차 추가 인증[기본 파라미터 + 추가 인증 파라미터] 요청으로 이루어집니다. 추가 인증은 사용자 인증을 위한 정보가 대부분이며 추가 인증 요청시에도 Endpoint URL은 동일합니다.

샌드박스 서버를 통해 추가인증 상품에 대한 테스트를 진행 할 수는 없습니다.

추가 인증에 필요한 파라미터 설명은 개발 가이드의 각 상품 페이지에서 확인할 수 있으며 자세한 내용은 개발가이드 추가인증을 통해 확인하세요.

4.다건요청

코드에프 API는 1개 요청 1개 응답을 원칙으로 합니다. 추가 인증이 필요한 상품인 경우 같은 고객이 요청 A와 요청 B를 호출할 경우 추가 인증을
두 번 해야 하는 번거로움이 있습니다. 다건 요청 기능을 활용하면 요청 A의 인증만으로 요청 B는 추가 인증 없이 응답받을 수 있습니다.

다건요청 기능에 대한 자세한 설명은 개발가이드 다건요청에서 확인할 수 있습니다.

- 건강보험공단 건강검진결과 다건요청 예제

// 건강보험공단 건강검진결과 (다건요청)
/** #1.쉬운 코드에프 객체 생성 및 클라이언트 정보 설정 */
EasyCodef codef = new EasyCodef();
codef.setClientInfoForDemo(DEMO_CLIENT_ID, DEMO_CLIENT_SECRET);
codef.setClientInfo(CLIENT_ID, CLIENT_SECRET);
codef.setPublicKey(PUBLIC_KEY);

/** #2.식별 아이디 생성 / 요청 식별 아이디(SSO(동일계정) 구분값) / 사용자 계정을 식별할 수 있는 유일 값 세팅 (ex. 아이디 + UUID)
 *  다건요청에서 사용되는 식별아이디는 각 요청에 필수로 입력해야 합니다.
 * */
ID = "testID" + UUID.randomUUID();

/** #3.다건 요청에 대한 결과값을 확인하기 위해 API요청 Thread를 생성하여 확인 */
for (int i = 0; i < 2; i++) {
    
    /** #4.요청 파라미터 설정 - 각 상품별 파라미터를 설정(https://developer.codef.io/products) */
    // 다건요청 확인을 위해 조회 연도를 다르게 설정
    // 요청A : 2018년도 데이터 / 요청 B : 2019년도 데이터
    String searchStartYear = String.valueOf(2018+i);
    String searchEndYear = String.valueOf(2018+i);

    HashMap<String, Object> parameterMap = new HashMap<String, Object>();
    parameterMap.put("organization", "0002");
    parameterMap.put("loginType", "5"); // "0":(공동/금융)인증서 "5":간편인증
    parameterMap.put("loginTypeLevel", "1");  // 1:카카오톡, 2:페이코, 3:삼성패스, 4:KB모바일, 5:통신사(PASS), 6:네이버, 7:신한인증서, 8: toss
    parameterMap.put("userName", "홍길동");
    parameterMap.put("phoneNo", "0101234xxxx");
    parameterMap.put("identity", "19000101");
    parameterMap.put("inquiryType", "0");

    parameterMap.put("id", ID); //식별아이디

    parameterMap.put("searchStartYear", searchStartYear);
    parameterMap.put("searchEndYear", searchEndYear);
    parameterMap.put("type", "1");

    /** #5.Thread 실행*/
    Thread t = new requestThread(codef, parameterMap, i);
    t.start();

    // API 요청A와 요청B 다건 요청을 위해서는 요청A 처리 후 요청B를 처리할 수 있도록
    // 요청A 송신 후 약 0.5초 ~ 1초 이내 요청B 송신 필요
    Thread.sleep(1000);
}

다건 요청 Thread 정의 예제

/** #6.다건 요청 확인을 위한 요청 Thread 정의 */
public class requestThread extends Thread{
    private EasyCodef codef;
    private HashMap<String, Object> parameterMap;
    private int threadNo;

    public requestThread(EasyCodef codef, HashMap<String, Object> parameterMap, int threadNo) {
        this.codef = codef;
        this.parameterMap = parameterMap;
        this.threadNo = threadNo;
    }

    @Override
    public void run() {

        /** #7.코드에프 정보 조회 요청 - 서비스타입(API:정식, DEMO:데모, SANDBOX:샌드박스) */
        String productUrl = "/v1/kr/public/pp/nhis-health-checkup/result";
        String result;
        String code;
        boolean continue2Way = false;

        try {
            result = codef.requestProduct(productUrl, EasyCodefServiceType.DEMO, parameterMap);
        } catch (UnsupportedEncodingException e) {
            throw new RuntimeException(e);
        } catch (JsonProcessingException e) {
            throw new RuntimeException(e);
        } catch (InterruptedException e) {
            throw new RuntimeException(e);
        }

        HashMap<String, Object> responseMap = null;
        try {
            responseMap = new ObjectMapper().readValue(result, HashMap.class);
        } catch (JsonProcessingException e) {
            throw new RuntimeException(e);
        }

        HashMap<String, Object> resultMap = (HashMap<String, Object>)responseMap.get("result");

        //추가 인증이 필요한 경우 result 객체의 응답코드가 CF-03002
        code = (String)resultMap.get("code");
        System.out.println("응답코드 : " + code);

        HashMap<String, Object> dataMap = (HashMap<String, Object>)responseMap.get("data");

        // data객체에 continue2Way 필드가 존재하는지 확인
        if (dataMap.containsKey("continue2Way")) {
            continue2Way = Boolean.valueOf((boolean)dataMap.get("continue2Way"));
        }

        // 응답코드가 CF-03002 이고 continue2Way 필드가 true인 경우 추가 인증 정보를 변수에 저장
        if (code.equals("CF-03002") && continue2Way){
            JOB_INDEX =  (int)dataMap.get("jobIndex");
            THREAD_INDEX = (int)dataMap.get("threadIndex");
            JTI = (String) dataMap.get("jti");
            TWO_WAY_TIMESTAMP = (Long)dataMap.get("twoWayTimestamp");
        }

        /** #8.결과값 확인 */
        System.out.println("threadNo " + threadNo + " result : " + result);
    }
}

요청 A 간편인증 완료 예제

/** #1.쉬운 코드에프 객체 생성 및 클라이언트 정보 설정 */
EasyCodef codef = new EasyCodef();
codef.setClientInfoForDemo(DEMO_CLIENT_ID, DEMO_CLIENT_SECRET);
codef.setClientInfo(CLIENT_ID, CLIENT_SECRET);
codef.setPublicKey(PUBLIC_KEY);

/** #2.추가인증 입력부 파라미터 설정 */
HashMap<String, Object> parameterMap = new HashMap<String, Object>();
parameterMap.put("organization", "0002"); //기관코드 필수 입력
parameterMap.put("id", ID); //식별아이디 필수 입력

//간편인증 추가인증 입력부
parameterMap.put("simpleAuth", "1");
parameterMap.put("is2Way", true);

/** #3.twoWayInfo 파라미터 설정*/
HashMap<String, Object> twoWayInfo = new HashMap<String, Object>();
twoWayInfo.put("jobIndex", JOB_INDEX);
twoWayInfo.put("threadIndex", THREAD_INDEX);
twoWayInfo.put("jti", JTI);
twoWayInfo.put("twoWayTimestamp", TWO_WAY_TIMESTAMP);

parameterMap.put("twoWayInfo", twoWayInfo);

// 요청 Endpoint는 동일함
String productUrl = "/v1/kr/public/pp/nhis-health-checkup/result";
String result;

// 추가인증 요청 시에는 이지코드에프.requestCertification 으로 호출
result = codef.requestCertification(productUrl, EasyCodefServiceType.DEMO, parameterMap);

/** #4.결과값 확인 */
System.out.println("요청A(추가인증) result : " + result);

Ask us

easycodef-java 라이브러리 사용에 대한 문의사항과 개발 과정에서의 오류 등에 대한 문의를 홈페이지 문의게시판에 올려주시면 운영팀이 답변을 드립니다. 문의게시판의 작성 양식에 맞춰 문의 글을 남겨주세요. 가능한 빠르게 응답을 드리겠습니다.