API Market | Sionlab

INTRO

API Market 이란

Sionlab API Market은 공공·기업·개인·금융 데이터를 단일 API로 정규화해 제공하는 맞춤 데이터 카탈로그입니다. 원천 기관의 공식 API와 스크래핑을 조합해, 클라이언트는 한 번의 호출로 여러 기관의 데이터를 통합 수신할 수 있습니다.

이 페이지에서 전체 개요를 확인하고, Market 탭 에서 카테고리·검색·정렬로 상품을 탐색하세요.

RUNTIME FLOW

데이터 요청 흐름

클라이언트의 요청이 Sionlab API 게이트웨이를 거쳐 원천 기관까지 전달되고, 정규화된 응답이 돌아오는 과정입니다. 4개 레인(End User · Client · Sionlab API · Organization)에서 각 단계가 어떻게 진행되는지 확인하세요.다이어그램을 클릭하면 데이터 흐름이 재생됩니다.

Runtime FlowSionlab APIstreaming

Tracing data flow

단계별 설명 (텍스트 보기)

서비스 요청 — 최종 사용자가 Client App에서 업무를 시작합니다.
accessToken 세팅 · 요청 조립 — Client는 인증 토큰과 요청 파라미터를 준비합니다.
API 요청 — Client가 Sionlab API 게이트웨이에 POST 요청을 보냅니다.
인증 검증 · 요청 정규화 — Sionlab이 토큰을 검증하고 입력을 표준 스키마로 변환합니다.
원천 호출 — Sionlab이 해당 원천 기관(공공·민간 API)을 호출합니다.
데이터 조회 — 원천 기관이 raw 데이터를 반환합니다.
필드 정규화 · 캐싱 — Sionlab이 기관별 raw 응답을 통합 스키마로 정규화하고, 허용된 영역은 캐싱합니다.
통합 응답 · 화면 제공 — Client가 결과를 받아 최종 사용자에게 보여줍니다.

End User

Client App을 실제로 사용하는 최종 사용자.

Client App

Sionlab API를 호출하는 파트너 서비스·인하우스 앱.

Sionlab API

인증·정규화·캐싱·감사 로그를 담당하는 게이트웨이.

Organization

데이터를 제공하는 원천 기관 (공공·민간).

Market 전체 보기 더 복잡한 흐름이 필요하다면 상담 신청

INTEGRATION PATTERNS

원천 통합 패턴

원천 기관 수에 따라 호출 패턴이 달라집니다. Single Source는 1개 기관에 여러 서브 API를 병렬 호출하고, Multi Source는 여러 기관을 원천별로 호출해 Sionlab이 응답을 병합합니다.

Pattern A

Single Source

단일 기관의 여러 서브 API를 한 번에 정규화

1 기관에 여러 서브 API를 병렬 호출해 한 번에 정규화합니다. 다이어그램을 클릭하면 흐름이 재생됩니다.

Pattern B

Multi Source

여러 기관 응답을 원천별로 통합

여러 기관 응답을 원천별로 수집해 통합 응답으로 병합합니다. 다이어그램을 클릭하면 흐름이 재생됩니다.

비교 요약 (텍스트 보기)

Single Source

1 기관에 여러 서브 API를 병렬 호출하고 단일 응답으로 정규화합니다. 단일 기관 데이터(예: 홈택스 전자세금계산서)에 적합합니다.

Multi Source

여러 기관을 원천별로 호출해 Sionlab이 병합·정합성 조율을 담당합니다. 다기관 통합 조회(예: 건강보험 · 국민연금 · 고용보험 이력)에 적합합니다.

Market 전체 보기 원천이 많거나 커스텀 스키마가 필요하다면 상담 신청

RESPONSE SHAPE

응답 구조

모든 Sionlab API는 result와 data 두 키로 구성된 JSON을 반환합니다. result는 공통 결과, data는 상품별 페이로드를 담습니다.

Key	Name	Type	Required	Description
resultObject · required	API 공통 결과	Object	O	성공·실패 코드와 메시지
dataObject · required	상품 데이터	Object	O	상품별 정규화 페이로드

{
  "result": {
    "code": "CF-00000",
    "message": "성공",
    "extraMessage": null,
    "transactionId": "f41d087dd6314"
  },
  "data": {
    "items": [ /* 상품별 정규화 필드 */ ]
  }
}