Restful API
[개요]
- bizplay에서 제공하는 API를 통해 ERP사에서 개발을 진행 합니다.

[그림1] API방식
① Message API 호출을 bizplay로 전송 합니다.
② 데이터 조회/전송을 수행 합니다.
③ 요청된 결과 값을 다시 전송 합니다.
※ 고객을 식별할 수 있는 고유 키를 발급해 드립니다.
※ 운영 환경은 Https 인증방식 암호화 합니다.
[방화벽 설정]
- bizplay는 OPEN API 로 연결 되어 아래와 같은 Out-Bound 방화벽 설정이 필요 합니다.
(In-bound 없음)

[그림2] 방화벽 설정
① bizplay는 목동 KT IDC센터에 금융 클라우드 센터로 운영 합니다.
② 도착지 호출은 URL 방식으로 내부 서버에서 DNS를 찾을 수 없으면 HOSTS파일에 등록해야 합니다.
③ 개발 API 전문테스트는 개발 작업 시 에만 필요 합니다.
④ 이미지 링크는 ERP나 GW에서 첨부 이미지 링크가 필요할 경우 사용 합니다.
[API 실습]
- GET방식으로 외부 사이트를 이용하여 실습을 합니다.

[그림3] API URL

2. ①"서비스 코드 목록"에 "카드 영수증 처리 내역 조회(0411)" 선택하여 ②"쿼리전송"을 클릭 합니다.
③ JSON_OUT 결과물이 나옵니다.
3. 결과 확인 http://jsonviewer.stack.hu/ 에 접속하여

[그림5] JSON Viewer 화면
4. ③번 결과물을 ④"Text" 항목 선택 후 붙여넣기를 합니다.
⑤"Format" 탭을 클릭하면 결과물이 정렬됩니다.

[그림6] JSON Viewer 화면
5. ⑥"viewer" 탭을 클릭하면 정렬된 결과물을 확인 할 수 있습니다.
▶ get 방식 API테스트
- URL 인코딩된 API 입력값 구하기
URL인코딩(base64) : Protocol로 사용하는 http URL에는 의미를 가진 문자가 있음 해당문자를 URL에
명령어로 인식하지 못하도록 암호화 하는 방법

① "서비스코드 목록" 에서 "카드 영수증 처리 내역 조회 (0411) 선택합니다.
② JSON_IN 입력된 내역을 복사합니다. 
[그림8] URL 인코딩
③ http://www.convertstring.com/ko/EncodeDecode/UrlEncode 접속하여
복사한 내역을 "여기에 URL 인코딩하고자하는..." 붙여 넣습니다.
④ "URL 인코딩!"을 클릭합니다.
⑤ "여기에 URL 인코딩 된 텍스트를 복사 : " 출력물 값을 복사합니다.
[그림9] 메모장
⑥ 메모장안에 "http://webankdev.appplay.co.kr/geteway.do?JSONData=" 입력합니다.
⑦에 ⑤결과물을 붙여 넣습니다.

[그림10] Chrome 주소란
⑧ "Chrome" 실행하여 주소란에 "{그림9} 메모장" 안에 있는 내용을 복사하여 붙여넣습니다.

[그림11] URL인코딩 실행 화면
⑨ URL 실행 후 결과물을 복사합니다.
위에 "▶ 개발 전문을 테스트 페이지에서 확인 합니다." 에서 3~5 설명되어 있는데로
실습을 합니다.
▶ 리바운드 전문
- 전문 통신 특성상 응답을 무한정 길게 전송이 불가능하기 때문에 일정 건별로 페이징을 반복하여
전문을 호출합니다.

[그림12] NEXT_KEY
① 쿼리전송을 하여 JSON_OUT 결과창에 "NEXT_KEY" 값이 있는지 확인합니다.
"NEXT_KEY" 값이 있으면 다음 페이지가 존재하기 때문에 다시 요청을 하여야 합니다.
② JSON_IN 창에 "NEXT_KEY" :" 뒤에 ①JSON_OUT 창에 나온 "NEXT_KEY"을 입력 후 쿼리전송을 합니다.
▶JOSN_IN 쿼리 설명
- JSON_IN 쿼리는 "공통부", "입력부"로 나누어 집니다.

[그림13] API 0910 조회
- http://webankdev.appplay.co.kr/api_test.jsp 접속하여
- "서비스코드 목록"에서 "거래종류 코드 조회(0910)" 선택 후 "쿼리전송"을 클릭합니다.
- 쿼리문
{① "API_ID" : "0910",
② "API_KEY" : "5a0d6070-1853-4e37-a4b0-fd11e5699296", "ORG_CD" : "2148635102",
③ "REQ_DATA" : {
④ "BIZ_NO" : "2148635102",
⑤ "REQ_CNT" : "",
⑥ "NEXT_KEY" : "" } }
- 공통부 설명
① 서비스코드 "거래종류 코드(0910)" 조회ID 입니다.
② 발급받은 "인증키"를 입력합니다.
- 입력부 설명
③ 입력부 시작 구분값입니다.
④ 조회하고자 하는 고객사 "사업자번호"를 입력합니다.
⑤ 조회할 "요청건수"를 입력합니다.
⑥ "다음결과키" 한화면에 일정 건수만 표시되어 다음건수 조회시 "JSON_OUT" 응답내용에
"NEXT_KEY" 입력합니다.
Last modified 3yr ago