오픈API

등록된 카드 목록 조회 v1.0.0

등록된 카드 목록 조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 등록된 카드 목록 조회
API 설명 등록된 카드 목록 조회
URL /ibk/biz/bizIndvEnprHoldCardInq
HTTP Method POST
OAuth 2.0 Y
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명
오픈API사용자일련번호oapiusersrnNumber100

클라이언트ID

X-IBK-Client-Id

String

320

클라이언트Sceret

X-IBK-Client-Secret

String

320

Authorization

Authorization

String

40000

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API클라이언트IDoapiClntIdString500
1오픈API카드대체번호_NEXTKEYcardListNextkeyOapiCardAltrNoString200
1페이지조회건수pageInqNbiNumber100

Request Sample

{
  "cardListNextkeyOapiCardAltrNo" : "sample_cardListNextkeyOapiCardAltrNo",
  "cardListRowcount" : 0.0,
  "cardList" : [ {
    "oapiInofrTgtNo" : "sample_oapiInofrTgtNo",
    "oapiCardAltrNo" : "sample_oapiCardAltrNo",
    "cdisYmd" : "sample_cdisYmd",
    "valdYm" : "sample_valdYm",
    "sttsDcd" : "sample_sttsDcd",
    "rprsPdm" : "sample_rprsPdm"
  } ]
}

Response Header

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1오픈API카드대체번호_NEXTKEYcardListNextkeyOapiCardAltrNoString200
1카드목록카운트cardListRowcountNumber50
1카드목록cardList

Array

00
2오픈API정보제공대상번호oapiInofrTgtNoString200
2오픈API카드대체번호oapiCardAltrNoString200
2카드발급년월일cdisYmdString80
2유효년월valdYmString60
2상태구분코드sttsDcdString10
2대표상품명rprsPdmString1000

Response Sample

{
  "cardListNextkeyOapiCardAltrNo" : "sample_cardListNextkeyOapiCardAltrNo",
  "cardListRowcount" : 0.0,
  "cardList" : [ {
    "oapiInofrTgtNo" : "sample_oapiInofrTgtNo",
    "oapiCardAltrNo" : "sample_oapiCardAltrNo",
    "cdisYmd" : "sample_cdisYmd",
    "valdYm" : "sample_valdYm",
    "sttsDcd" : "sample_sttsDcd",
    "rprsPdm" : "sample_rprsPdm"
  } ]
}

성공/실패 Case