headless

은행·카드·홈택스
확인 시간을 줄여보세요

매번 로그인하고 엑셀을 내려받는 대신,
필요한 기간과 자료를 골라 조회하세요.
제품, ERP, AI 업무 흐름에 바로 연결되는 형식으로 확인할 수 있습니다.

terminal
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"
    }
  }'
78
연결 가능한 기관
31
조회 가능한 데이터
12
업무에 맞춘 형식
// use cases

어디에 쓸지 먼저 정해보세요

제품 화면, ERP, 재무 자동화처럼 실제로 데이터가 쓰일 곳에 맞춰 시작할 수 있습니다. 필요한 예시와 실행 방법을 함께 확인하세요.

API 연동: 플랫폼

제품 화면에 보여주기

사용자가 은행·카드·홈택스 자료를 직접 올리지 않아도, 내 제품 안에서 필요한 금융 데이터를 불러오는 시나리오.

  • 은행 입출금내역 1개월 받기
  • 이커머스 셀러 PG ↔ 은행 정산 대사
  • 이커머스 셀러 월말 정산 차이 PR
이 흐름 살펴보기
API 연동: 자체 ERP·어드민

ERP에 채우기

월말마다 엑셀을 내려받아 붙이는 일을 줄인다. 정산, 대사, 예산, 감사 자료를 내부 시스템에 채우는 시나리오.

  • 월말 입출금내역을 PR 로 받기
  • 주간 다종 수집을 한 PR로 합본
  • 감사 · 재실행용 Artifact 보존
이 흐름 살펴보기
CLI·AI 연동: 재무 업무 자동화

반복 조회 줄이기

반복 조회와 리포팅을 터미널, AI 에이전트, GitHub Actions에 맡긴다. 팀이 보는 화면과 파일에 필요한 데이터만 남기는 시나리오.

  • 매출 세금계산서 한 번 받기
  • 수집 후 Slack 알림
  • 다중 기관 병렬 수집
이 흐름 살펴보기
// providers

기관마다 다른 확인 과정을 줄일 수 있습니다

은행, 카드사, 홈택스마다 로그인 방식과 자료 형식이 다릅니다. 필요한 기관을 고르고 같은 흐름으로 조회하세요.

국민
신한
하나
우리
농협
기업
SC제일
카카오뱅크
토스뱅크
케이뱅크
수협
대구
부산
광주
전북
경남
제주
새마을
신협
우체국
삼성카드
신한카드
현대카드
KB국민카드
롯데카드
우리카드
하나카드
BC카드
NH카드
씨티카드
홈택스
+47

78개 기관의 데이터를 같은 방식으로 조회할 수 있습니다.

// developers

팀이 편한 도구에서 시작하세요

콘솔, 터미널, AI 도구 중 익숙한 곳에서 자격증명을 등록하고 데이터를 조회할 수 있습니다. 한 번 등록하면 어느 도구에서든 같은 흐름으로 이어집니다.

API Reference

필요한 호출 찾기

엔드포인트와 스키마를 검색하고, 코드 샘플로 호출 형식을 확인합니다.

CLI

터미널에서 실행하기

콘솔 없이 터미널에서 로그인, 자격증명 등록, 첫 데이터 조회까지 진행합니다.

npm i -g @h6s-ai/cli && h6s init
AI Toolkit

AI 도구에서 조회하기

Claude Code · Cursor · Gemini에서 자연어로 조회를 요청하고 같은 API 결과를 받습니다.

npx @h6s-ai/toolkit install --target=cursor
파트너 연동

브라우저에서 연동 테스트

사업자등록번호, 자격증명 등록, data-job 수집 흐름을 한 화면에서 확인합니다.

코드 샘플

요청 예시 확인하기

curl 한 줄로 요청을 보내고 JSON 응답을 확인합니다.

// features

자료 형식을 맞추는 시간을 줄입니다

Unified Endpoint

은행, 카드, 홈택스 요청을 같은 방식으로 보낼 수 있습니다.

POST /api/v1/data-jobs HTTP/1.1
Host: api.h6s.ai
Authorization: Bearer h6s_live_***
Content-Type: application/json

Standardized Schema

거래내역, 세금계산서, 카드 승인 데이터를 같은 필드 구조로 확인하세요.

{
  "schema": "bank.transactions.cb.v1"
}

Auto-Chunking

조회 기간이 길어도 작업 상태와 실패 원인을 확인할 수 있습니다.

{
  "dateRangeStart": "2026-01-01",
  "dateRangeEnd":   "2026-12-31",
  "totalTaskCount": 12,
  "chunkSizeDays":  30
}
// advantages

처음 연동한 뒤의 관리 부담도 줄입니다

기관 변경 대응 시간을 줄입니다

기관 화면이나 응답이 바뀌어도 호출 코드는 그대로 둡니다. 실패한 작업은 자동으로 재시도하고, 상태와 원인을 확인할 수 있습니다.

  • 기관 변경 대응 시 내 연동 코드 수정 최소화
  • 네트워크 오류·타임아웃 재시도
  • 긴 조회 기간 자동 분할
  • 작업 상태와 실패 원인 확인

민감 정보를 직접 보관하지 않아도 됩니다

인증서·비밀번호·접근 정보는 암호화해 보관합니다. 평문을 서비스 서버에 둘 필요가 없습니다.

  • 인증서·비밀번호 AES-256 암호화 저장
  • 복호화 키와 저장 데이터 분리
  • 서비스 서버에 민감 정보 보관 불필요
  • 접근 로그 감사 추적

새 기관도 같은 방식으로 연동합니다

기관이나 액션이 늘어나도 같은 요청 구조를 유지합니다. 새 스키마를 골라 기존 흐름에 연결하면 됩니다.

  • 새 기관 추가 시 동일 API로 지원
  • 액션 추가 시 기존 호출 흐름 유지
  • 하위 호환성 보장
  • 78개 기관 동일 스펙으로 연동

내 시스템 흐름에 맞춰 호출합니다

프론트 대기 흐름, 배치 작업, 큐 기반 처리 중 팀의 운영 방식에 맞는 인터페이스를 고릅니다.

  • 동기 HTTP: 요청 후 응답
  • 비동기 HTTP (Polling): 상태 조회
  • 비동기 HTTP (Webhook): 완료 시 콜백
  • Queue (SQS, Kafka): 메시지 기반 연동
// workflow

등록, 조회, 확인 순서로 진행합니다

01

Connect

기관과 인증 방식을 고르고 접근 정보를 등록합니다.

POST /api/v1/credentials
{ "providerCode": "CB_WOORI", "authMethod": "ID", "displayName": "우리 메인", "credentials": { ... } }
02

Collect

필요한 기간과 데이터 종류를 정해 조회 작업을 만듭니다.

POST /api/v1/data-jobs
{ "providerCode": "CB_SHINHAN", "schema": "bank.transactions.cb.v1", "params": { "dateRangeStart": "2026-03-01", "dateRangeEnd": "2026-03-31" } }
03

Normalize

완료된 결과를 표준 형식으로 확인하고 바로 활용합니다.

GET /api/v1/data-jobs/{id}/results
{ "schema": "bank.transactions.cb.v1", "totalCount": 124, "data": [...] }
// security

민감한 접근 정보는 코드와 분리해 관리합니다

AES-256 암호화

인증서·비밀번호 같은 자격증명은 암호화된 값으로만 저장됩니다.

인증서 보호

공동인증서와 기관 인증 파일을 서비스 코드와 분리해 관리합니다.

민감 정보 마스킹·최소 권한

서비스 서버에 평문을 두지 않고, 운영 로그의 민감 값은 마스킹합니다.

API 키 기반 접근 제어

워크스페이스와 API 키 단위로 호출 범위를 나눠 관리합니다.

// pricing

필요한 처리량에 맞춰 선택합니다

무료

₩0/월

 

  • 동시 처리 1건
  • 월 수집 요청 20건
  • 무제한 API 키 · 자격증명
  • 이메일 지원
추천

스탠다드 1x

₩1,000,000/월 (VAT 별도)

연 결제 시 ₩900,000/월 · 10% 할인

  • 동시 처리 2건: 통장·카드 등 주요 계정 동시 갱신
  • 무제한 수집 요청
  • 무제한 API 키 · 자격증명
  • 실시간 지원 (슬랙)

엔터프라이즈

커스텀

 

  • 동시 처리 협의 (2x · 4x · 8x · 16x+)
  • 전담 엔지니어 배정
  • 전담 지원
엔터프라이즈

영업 문의하기

맞춤형 플랜과 전담 지원을 안내해 드립니다.
간단한 정보를 남겨주시면 빠르게 연락드리겠습니다.

headless