고시은행, 고시일자, 환종별 환율 정보를 제공합니다
1 요청URL
GET |
|
POST |
URL -
https://api.goodapi.co.kr/api/ExchangeRates?sessionID=공개키
샘플
-
https://api.goodapi.co.kr/api/ExchangeRates?sessionID=test
- [application/x-www-form-urlencoded]
-
path01=081&date=20191021
- [application/xml]
-
<R><path01>081</path01><date>20191021</date></R>
- [application/json]
-
{"path01":"081","date":"20191021"}
주의사항
- filename, type, eCode, serviceKey, subFileName, wcfName 요청변수명은 사용이 불가하며,
- path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
- 요청변수명 중복사용시 Query보다 Body가 우선함.
|
2 요청변수
구분 |
요청변수 |
변수명 |
유형 |
필수 |
샘플값 |
설명 |
Path |
fileName |
요청 업무 |
string |
true |
ExchangeRates
|
ExchangeRates
추가/변경 가능
|
path01 |
은행코드 |
int |
true |
081 |
3자리은행코드 |
path02 |
환종 |
string |
false |
|
조회하고자 하는 환종(USD,JPY,EUR) |
Query |
returnType | 응답형식 | string | false | xml | xml or json HTTP Header의 Accept 사용 권장 |
eCode |
법인코드 |
string |
false |
Dataservice |
요청 처리하고자 하는 법인코드 |
sessionID |
공개키 |
string |
true |
test |
접근하려는 연계시스템 또는 사용자에 부여하는 Key값 |
subFileName |
요청 업무(구분) |
string |
false |
088 |
요청 업무 세부 구분 코드(예-은행코드) |
date |
고시일자 |
date |
false |
20191021 |
조회하고자 하는 고시일자(8자리) |
3 출력결과필드
출력변수 |
유형 |
샘플값 |
설명 |
R_CODE |
responseindex |
0000 |
처리결과코드 |
R_MSG |
responseindex |
정상 처리되었습니다 |
처리결과메세지 |
ExchangeRates |
table[0] |
|
환율정보 |
컬럼명 |
샘플값 |
설명 |
환율일자 |
20191021 |
|
은행코드 |
081 |
고시은행코드 |
환율회차 |
1 |
|
통화코드 |
USD |
|
국명 |
미국 |
|
통화고시구분 |
1 |
1:고시, 2:비고시 |
TTBUYING허용여부 |
True |
|
TTSELLING허용여부 |
True |
|
CASHBUYING허용여부 |
True |
|
CASHSELLING허용여부 |
True |
|
CHECKBUYING허용여부 |
True |
|
송금보낼때 |
1192.00 |
|
송금받을때 |
1169.00 |
|
송금보낼때우대 |
0.00 |
|
송금받을때우대 |
0.00 |
|
현찰사실때 |
1201.15 |
|
현찰파실때 |
1159.85 |
|
스프레드사실때 |
1.75 |
|
스프레드파실때 |
1.75 |
|
외화수표파실때 |
1167.79 |
|
매매기준율 |
1180.50 |
|
대미환산율 |
1.0000 |
|
TC사실때 |
1194.66 |
|
TC파실때 |
0.00 |
|
환가료1년 |
3.70025 |
|
환가료구10일 |
0.10278 |
|
환가료12일 |
0.12334 |
|
환가료1개월 |
0.00000 |
|
환가료3개월 |
4.45325 |
|
비고 |
|
|
환율시간 |
2019-10-21 오전 8:34:45 |
|
|
4 추가응답코드
개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
5 Test API
Header
|
Key |
Value |
비고 |
|
Content-Type
|
application/x-www-form-urlencoded
|
application/xml application/json
|
|
Accept
|
|
application/xml application/json
|
|
Authorization
|
|
토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
|
|
client_id
|
|
접속회원ID
|
|
client_secret
|
|
접속비밀번호
|
|
serviec_key
|
|
서비스Key
|
|
user-tr-no
|
|
요청자 거래고유번호(요청자 생성)
|
Response
[POST]
https://api.goodapi.co.kr/api/ExchangeRates?sessionID=test
Body
Response