curl -X POST https://api.h6s.ai/api/v1/data-jobs \
-H "Authorization: Bearer h6s_live_..." \
-H "Content-Type: application/json" \
-d '{
"providerCode": "CB_SHINHAN",
"schema": "bank.transactions.cb.v1",
"params": {
"dateRangeStart": "2026-03-01",
"dateRangeEnd": "2026-03-31"
}
}'Why headless
Unified Endpoint
다양한 인증 방식을 하나의 엔드포인트로 통합. 기관별 차이를 추상화합니다.
POST /api/v1/data-jobs HTTP/1.1
Host: api.h6s.ai
Authorization: Bearer h6s_live_***
Content-Type: application/jsonStandardized Schema
6개 표준 데이터 형식으로 데이터 정규화. 기관이 달라도 응답 구조는 하나입니다.
{
"schema": "bank.transactions.cb.v1"
}Auto-Chunking
긴 기간 요청을 chunk 단위로 자동 분할 · 병렬 실행 후 결과를 합쳐 한 번에 돌려줍니다.
{
"dateRangeStart": "2026-01-01",
"dateRangeEnd": "2026-12-31",
"totalTaskCount": 12,
"chunkSizeDays": 30
}기존 API와 다릅니다
운영 부담을 줄입니다
기관 인터페이스가 변경되어도 headless가 대응합니다. 재시도, 청킹, 장애 복구를 지원합니다.
- 기관 변경 시 자동 대응 — 고객 코드 수정 불필요
- 네트워크 오류·타임아웃 자동 재시도
- 대용량 조회 자동 청킹 처리
- 수집 상태 실시간 모니터링
접근 정보, 철저하게 보호합니다
인증서·비밀번호·접근 정보를 봉투 암호화해 보관하고, 스크래핑 실행 시점에만 복호화합니다. 평문은 영속 저장소에 남지 않습니다.
- 인증서·비밀번호 AES-256 암호화 저장
- 복호화 키와 분리해 봉투 암호화 보관
- 고객사 서버에 민감 정보 보관 불필요
- 접근 로그 감사 추적
코드 변경 없이 확장
새로운 기관이나 액션이 추가되어도 기존 연동 코드는 그대로 유지됩니다. API 스펙 변경 없이 사용할 수 있습니다.
- 새 기관 추가 시 동일 API로 지원
- 액션 추가 시 SDK·코드 업데이트 불필요
- 하위 호환성 보장
- 78개 기관 동일 스펙으로 연동
원하는 방식으로 연동하세요
시스템 아키텍처에 맞는 인터페이스를 선택할 수 있습니다. 동기부터 비동기, 메시지 큐까지.
- 동기 HTTP — 요청 후 응답
- 비동기 HTTP (Polling) — 상태 조회
- 비동기 HTTP (Webhook) — 완료 시 콜백
- Queue (SQS, Kafka) — 메시지 기반 연동
How it works
Connect
금융 기관 인증서를 등록하고 자격증명을 설정합니다.
POST /api/v1/credentials{ "providerCode": "CB_SHINHAN", "authMethod": "ID", "displayName": "신한 메인", "credentials": { ... } }Collect
요청 한 번으로 데이터를 수집합니다. 기간이 길면 구간을 나눠 요청하고, 실패하면 다시 시도합니다.
POST /api/v1/data-jobs{ "providerCode": "CB_SHINHAN", "schema": "bank.transactions.cb.v1", "params": { "dateRangeStart": "2026-03-01", "dateRangeEnd": "2026-03-31" } }Normalize
정규화된 표준 데이터 형식으로 데이터를 활용합니다. 기관별 차이는 headless가 처리합니다.
GET /api/v1/data-jobs/{id}/results{ "schema": "bank.transactions.cb.v1", "totalCount": 124, "data": [...] }어떤 형태로 쓰나
플랫폼 통합 · 내부 시스템 적재 · 로컬 대시보드 — 데이터가 흘러가는 곳에 따라 세 가지 형태.
플랫폼 통합으로 내 서비스에 연동
headless 를 데이터 공급원으로 내 서비스에 통합한다. 받은 데이터를 내 제품의 사용자·고객에게 다시 흘려보내는 시나리오.
- 은행 입출금내역 1개월 받기
- 이커머스 셀러 PG ↔ 은행 정산 대사
- 이커머스 셀러 월말 정산 차이 PR
회사 어드민·ERP로 내부 시스템 적재
회사 어드민·ERP·정산 시스템에 금융 데이터를 자동으로 채운다. 월말 정산·대사·부서 예산·감사 추적에 쓰는 시나리오.
- 월말 입출금내역을 PR 로 받기
- 주간 다종 수집을 한 PR로 합본
- 감사 · 재실행용 Artifact 보존
내 화면에서 바로 쓰는 로컬 대시보드
로컬에서 데이터를 받아 대시보드·리포트를 직접 만든다. 주간 캐시플로우·Slack 리포팅·1인 사장 신고 자료처럼 데이터가 내 화면·내 파일에 머무는 시나리오.
- 매출 세금계산서 한 번 받기
- 수집 후 Slack 알림
- 다중 기관 병렬 수집
78+ 금융기관
은행, 카드사, 홈택스. 하나의 API로 모두 연결합니다.
78+ 금융기관. 하나의 API.
보안은 기능이 아니라 전제입니다.
AES-256 암호화
인증서·비밀번호 등 자격증명은 AES-256으로 암호화해 저장합니다.
인증서 보호
공동인증서·기관 인증 파일도 자격증명과 동일하게 암호화해 보관합니다.
민감정보 마스킹·최소 권한
운영 로그로 나가는 민감 값은 마스킹하고, 인프라 권한을 최소화합니다.
API 키 기반 접근 제어
API 키 단위로 권한과 호출량을 세밀하게 제어합니다.
원하는 방식으로 호출하세요
REST · CLI · AI 에이전트 — 같은 데이터를 네 가지 채널로 제공합니다.
@h6s-ai/cli
터미널 한 줄로 시작. `h6s init` 한 번이면 로그인 · 자격증명 · 첫 수집 요청까지 자동.
npm i -g @h6s-ai/cli && h6s init@h6s-ai/toolkit
Claude Code · Cursor · Gemini 에서 자연어로 호출. MCP 서버 매니페스트가 같이 들어있습니다.
npx @h6s-ai/toolkit install --target=cursorPricing
스탠다드 1x
연 결제 시 ₩900,000/월 · 10% 할인
- 동시 처리 2건 — 통장·카드 등 주요 계정 동시 갱신
- 무제한 수집 요청 · 무제한 스크래핑 단계
- 무제한 API 키 · 자격증명
- 실시간 지원 (슬랙)
엔터프라이즈
- 동시 처리 협의 (2x · 4x · 8x · 16x+)
- 전담 엔지니어 배정
- 전담 지원