굿센 뱅크북서비스로 등록된 계좌의 증권계좌현황을 조회합니다
1 요청URL
POST |
URL -
https://api.goodapi.co.kr/api/StockAssetStatement?type={xml or json}&sessionID=공개키
샘플
-
https://api.goodapi.co.kr/api/StockAssetStatement?type=xml&sessionID=test
- [application/x-www-form-urlencoded]
-
tradedate=20200101&bankcode=003&acctno=(계좌번호)&currcd=KRW&selectseq=L
- [application/xml]
-
<R><tradedate>20200101</tradedate><bankcode>003</bankcode><acctno>(계좌번호)</acctno><currcd>KRW</currcd><selectseq>L</selectseq></R>
- [application/json]
-
{"tradedate":"20200101","bankcode":"003","acctno":"(계좌번호)","currcd":"KRW","selectseq":"L"}
주의사항
- filename, type, eCode, sessionID, subFileName, wcfName 요청변수명은 사용이 불가하며,
- path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
- 요청변수명 중복사용시 Query보다 Body가 우선함.
|
2 요청변수
구분 |
요청변수 |
변수명 |
유형 |
필수 |
샘플값 |
설명 |
Path |
fileName |
요청 업무 |
string |
true |
StockAssetStatement
|
StockAssetStatement
추가/변경 가능
|
Query |
type | 응답형식 | string | true | xml | xml or json |
eCode |
법인코드 |
string |
false |
Dataservice |
요청 처리하고자 하는 법인코드 |
sessionID |
공개키 |
string |
true |
test |
접근하려는 연계시스템 또는 사용자에 부여하는 Key값 |
subFileName |
요청 업무(구분) |
string |
false |
088 |
요청 업무 세부 구분 코드(예-은행코드) |
Body |
tradedate |
조회일자 |
date |
true |
20200101 |
|
bankcode |
은행코드 |
string |
true |
003 |
금결원 표준은행코드를 입력 |
acctno |
계좌번호 |
string |
true |
|
|
currcd |
통화코드 |
string |
false |
KRW |
|
selectseq |
조회회차 |
string |
true |
L |
|
3 출력결과필드
출력변수 |
유형 |
샘플값 |
설명 |
R_CODE |
responseindex |
0000 |
처리결과코드 |
R_MSG |
responseindex |
정상 처리되었습니다 |
처리결과메세지 |
LastQueriedDatetime |
responseindex |
2000-01-01 00:00:00 |
해당 계좌가 마지막으로 조회실행된 시간(YYYY-MM-DD HH24:MI:SS) |
LastRepondDate |
responseindex |
20000101 |
해당 계좌가 조회한 최근일자(YYYYMMDD) |
StockAssetStatement |
table[0] |
|
|
4 추가응답코드
개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
5 Test API
Header
|
Key |
Value |
비고 |
|
Content-Type
|
application/x-www-form-urlencoded
|
application/xml application/json
|
|
Authorization
|
|
토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
|
|
client_id
|
|
접속회원ID
|
|
client_secret
|
|
접속비밀번호
|
|
session_id
|
|
Session ID
|
|
user-tr-no
|
|
요청자 거래고유번호(요청자 생성)
|
[POST]
https://api.goodapi.co.kr/api/StockAssetStatement?type=json&sessionID=test
Body
Response