본 문서에서는 Block Store에 등록된 Block Package를 구독하고 다운받아 BizUnit에서 활용하는 방법을 소개합니다.
Index
Plan Control
•
Block Store 접근 권한은 구독하신 Plan에 의해 제어합니다.
Free | Starter | Plus | Pro | Enterprise | |
Block Store | ✓ | ✓ | ✓ | ✓ | ✓ |
개요
1) Block Store란?
•
Block Store는 공공데이터, 금융, 마이데이터 및 결제 등 다양한 플랫폼에서 API 형태로 제공되는 서비스를 SyncTree에서 Block Coding으로 활용할 수 있도록 Block Package 형태로 관리하는 시스템입니다.
•
Block Package는 Block Provider가 등록한 사용료 정책에 따라 무료, 유료로 사용 가능합니다.
•
Block Package의 과금은 해당 Block을 사용한 서비스(BizUnit)를 실제로 한번 호출하는 것을 1call로 산정하여 계산합니다.
2) 용어 정리
•
Block : 특정한 서비스(API)가 블록으로 구현된 하나의 애플리케이션입니다.
•
Block Package : Block을 기능별, 용도별로 묶어 서비스 단위로 제공하는 Block들의 모임입니다.
•
Block Provider : Block 및 Block Package의 생산자입니다.
•
Block Store : Block Provider가 등록한 Block Package를 사용자가 확인할 수 있는 페이지로, SyncTree Studio에서 접근합니다.
3) Block Store Flow
•
Step 1 : Block Provider가 Block Store에 Block Package를 등록합니다.
•
Step 2 : SyncTree 사용자는 Block Store에서 Block Package를 구독하고 다운받아 사용합니다.
•
Step 3 : Block 사용량 계산 후 Block Package 정책에 따라 요금을 지불합니다.
•
Step 4 : Block Provider에게 Block Package의 사용 금액을 지급합니다.
Block Package 구독
1) Move to All Blocks
•
All Blocks 메뉴에서 등록된 다양한 Block Package를 확인합니다.
No. | 설명 |
1 | Block Package를 키워드로 검색합니다. |
2 | 최근 등록된 Block Package 내역입니다. |
3 | 많이 사용된 Block Package 내역입니다. |
4 | Block Store Admin에서 추천하는 Block Package를 큐레이션하여 보여줍니다. |
5 | 등록된 모든 Block Package를 카테고리에 따라 분류하여 보여줍니다.
* Block Package가 없는 카테고리는 노출되지 않습니다.
Category)
AI / Hosting / Social Media / Portal / Chat / Weather / Location / Collaboration / Transportation / Health / Payment / Medical / Tools / Business / Finance / ETC |
2) All Blocks 상세 페이지
•
Block Package를 선택해 상세 페이지로 접근할 수 있으며, 여기서 Block Package의 내용을 확인하고 구독합니다.
No. | 설명 |
1 | Block Package의 구독/구독 해지를 결정합니다.
* Block Package를 구독한 이후 BiUnit에 연결되어 있을 경우, 먼저 연결을 해제해야 구독 해지가 가능합니다. |
2 | Block Package를 사용하기 위한 Package Guide 링크 버튼입니다.
* Block Provider가 Guide를 등록하지 않았을 경우 노출되지 않습니다. |
3 | Block Provider의 정보와 Block 사용 시 과금되는 비용 안내입니다.
* Block Provider가 Cost를 등록하지 않았을 경우 노출되지 않습니다. |
4 | Block Package의 Version을 선택합니다.
Version에 따라 Description과 Block의 내용이 바뀝니다. |
5 | Block Package의 소개와 주요 기능을 담은 설명 영역입니다. |
6 | Block을 선택하면 Block을 사용하기 위한 parameter와 명세서 정보를 보여주는 팝업이 노출됩니다. |
•
Block Package를 구독하면 아래의 안내 메시지 스낵바가 노출됩니다.
| 구독이 완료되었으며, ‘My Blocks’ 에서 확인할 수 있습니다.
Block Download
1) Move to My Blocks
•
My Blocks 메뉴에서는 구독한 Block Package 내역을 확인할 수 있습니다.
No. | 설명 |
1 | 구독한 Block Package를 Package Title과 Provider로 검색할 수 있습니다.
검색 결과 갯수가 Result로 표기됩니다. |
2 | 선택한 Block Package의 상세 페이지로 연결됩니다.
Package Title 오름차순/내림차순 정렬을 지원합니다. |
3 | 구독한 Block Package 중 Used Version이 체크된 Package Version을 표시합니다. |
4 | Block Package가 사용 중인 BizUnit을 알려주는 팝업 창이 노출됩니다.
* Revision Used의 값이 ‘0’이어야 Block Package의 구독 해지가 가능합니다. |
5 | Block Package를 Block Package Update 날짜 오름차순/내림차순 정렬을 지원합니다. |
2) My Blocks 상세 페이지
•
Block Package를 선택해 상세 페이지로 접근할 수 있으며, 여기서 Block Package를 다운받을 수 있습니다.
No. | 설명 | 비고 |
1 | Block Package의 구독 해지를 결정합니다.
* Block Package를 구독한 이후 BiUnit에 연결되어 있을 경우, 먼저 연결을 해제해야 구독 해지가 가능합니다. | - |
2 | Block Package를 사용하기 위한 Package Guide 링크 버튼입니다.
* Block Provider가 Guide를 등록하지 않았을 경우 노출되지 않습니다. | - |
3 | Block Provider의 정보와 Block 사용 시 과금되는 비용 안내입니다.
* Block Provider가 Cost를 등록하지 않았을 경우 노출되지 않습니다.
Block Package가 사용 중인 BizUnit을 알려주는 팝업 창이 노출됩니다.
* Revision Used의 값이 ‘0’이어야 Block Package의 구독 해지가 가능합니다. | - |
4-1 | Block Package의 Version을 선택합니다.
Version에 따라 Description과 Block의 내용이 바뀝니다. | 4-2, 4-3을 수행하기 위한 선행 조건입니다. |
4-2 | Version 선택 이후 블록을 다운로드합니다. | 4-1을 선행해야 합니다. |
4-3 | 블록 다운로드 버튼이 비활성화된 이 Used Version 토글 버튼이 노출되며, On 상태로 바꿔주면 BlzUnit의 Block Category에 노출됩니다. | 4-2를 선행해야 합니다. |
5 | Block Package의 소개와 주요 기능을 담은 설명 영역입니다. | - |
6 | Block을 선택하면 Block을 사용하기 위한 parameter와 명세서 정보를 보여주는 팝업이 노출됩니다. | - |
7 | Block의 Version을 표시합니다. | Block Package Version ≠ Block Version |
8 | 해당 Version의 Block이 사용 중인 BizUnit만 알려주는 팝업창이 노출됩니다. | - |
BizUnit에서 Block 적용
1) Move to BizUnit
•
다운로드 이후 Used Version이 활성화 된 Block은 BizUnit의 Block Package Category에 등록되며, Block Coding 방식으로 사용할 수 있습니다.
2) Block Architecture 구성
•
각 Block에 따라 사용하는 방법이 조금씩 다르기 때문에, Package Guide와 Block 명세서 등을 참고하여 Block Coding을 진행합니다.
•
Block은 특정 서비스를 호출하기 위해 Endpoint와 Http method가 고정돼 있으며, 몇 가지 작업을 수행해야 합니다.
◦
Block의 Request Parameter 설정
◦
Block의 Response Data Fetch
•
Step 1 : Client로부터 받을 Request Parameter 구성
Stpe 2 : RequestData Fetch
Step 3 : Block 구성, Block의 Request Parameter 설정
Step 4 : Block의 Response Data Fetch
Stpe 5: 응답 결과 반환
Step 6 : Test
Bizunit 전체 이미지
Block 사용량 확인
•
Block Store Usage Reports에서 Block 사용량과 요금을 확인할 수 있습니다.
