headless

Financial data,
headless.

홈택스 · 은행 · 카드사.
78개 기관의 데이터를 하나의 API로.

terminal

curl -X POST https://api.h6s.ai/v1/data-jobs \
  -H "Authorization: Bearer h6s_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "connector_id": "conn_01",
    "action": "bank.transactions",
    "date_range_start": "2026-03-01",
    "date_range_end": "2026-03-31"
  }'

78+

금융기관

데이터 액션

표준 스키마

// features

Why headless

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

Unified Endpoint

다양한 인증 방식을 하나의 엔드포인트로 통합. 기관별 차이를 추상화합니다.

{
  "schema": "bank.transactions",
  "normalized": true
}

Standardized Schema

12개 표준 스키마로 데이터 정규화. 기관이 달라도 응답 구조는 하나입니다.

"가맹점명"  → "스타벅스 강남점"
"category" → "F&B/카페"
"amount"   → 4,500
"type"     → "오프라인"

AI Classification

가맹점명과 카테고리를 자동 매핑. 비정형 데이터를 구조화합니다.

// advantages

기존 API와 다릅니다

운영 부담 제로

기관 인터페이스가 변경되어도 headless가 자동으로 대응합니다. 재시도, 청킹, 장애 복구까지 알아서.

기관 변경 시 자동 대응 — 고객 코드 수정 불필요
네트워크 오류·타임아웃 자동 재시도
대용량 조회 자동 청킹 처리
수집 상태 실시간 모니터링

접근 정보, 철저하게 보호합니다

인증서, 비밀번호, 접근 정보를 암호화하여 격리된 저장소에 보관합니다. 파일이 유출될 걱정이 없습니다.

인증서·비밀번호 AES-256 암호화 저장
격리된 보안 저장소에서 관리
고객사 서버에 민감 정보 보관 불필요
접근 로그 감사 추적

코드 변경 없이 확장

새로운 기관이나 액션이 추가되어도 기존 연동 코드는 그대로. API 스펙 변경 없이 즉시 사용할 수 있습니다.

새 기관 추가 시 동일 API로 즉시 지원
액션 추가 시 SDK·코드 업데이트 불필요
하위 호환성 보장
78개 기관 동일 스펙으로 연동

원하는 방식으로 연동하세요

시스템 아키텍처에 맞는 인터페이스를 선택할 수 있습니다. 동기부터 비동기, 메시지 큐까지.

동기 HTTP — 즉시 응답
비동기 HTTP (Polling) — 상태 조회
비동기 HTTP (Webhook) — 완료 시 콜백
Queue (SQS, Kafka) — 메시지 기반 연동

// api

Simple API

하나의 엔드포인트. 표준 스키마. 5분이면 첫 API 호출.

request.sh

POST /api/v1/connectors/1/data-jobs
Authorization: Bearer h6s_live_...
Content-Type: application/json

{
  "actionCode": "bank.transactions",
  "dateRangeStart": "2026-03-01",
  "dateRangeEnd": "2026-03-31"
}

response.json

{
  "id": 42,
  "connectorId": 1,
  "actionCode": "bank.transactions",
  "status": "COMPLETED",
  "results": [
    {
      "date": "2026-03-15",
      "description": "스타벅스 강남점",
      "amount": -4500,
      "balance": 1234567,
      "category": "F&B/카페"
    }
  ],
  "totalTaskCount": 3,
  "completedTaskCount": 3
}

request.sh

POST /api/v1/connectors/1/data-jobs
Authorization: Bearer h6s_live_...
Content-Type: application/json

{
  "actionCode": "bank.transactions",
  "dateRangeStart": "2026-03-01",
  "dateRangeEnd": "2026-03-31"
}

response.json

{
  "id": 42,
  "connectorId": 1,
  "actionCode": "bank.transactions",
  "status": "COMPLETED",
  "results": [
    {
      "date": "2026-03-15",
      "description": "스타벅스 강남점",
      "amount": -4500,
      "balance": 1234567,
      "category": "F&B/카페"
    }
  ],
  "totalTaskCount": 3,
  "completedTaskCount": 3
}

// workflow

How it works

Connect

금융 기관 인증서를 등록하고 커넥터를 설정합니다.

POST /api/v1/connectors

{ "providerId": 1, "credentials": { ... } }

Collect

API 한 줄로 데이터를 수집합니다. 청킹과 재시도는 자동입니다.

POST /api/v1/data-jobs

{ "connectorId": 1, "action": "bank.transactions" }

Normalize

정규화된 표준 스키마로 데이터를 활용합니다. 기관별 차이는 headless가 처리합니다.

GET /api/v1/data-jobs/42/results

{ "schema": "bank.transactions", "data": [...] }

// providers

78+ 금융기관

은행, 카드사, 홈택스. 하나의 API로 모두 연결합니다.

국민

신한

하나

우리

농협

기업

SC제일

카카오뱅크

토스뱅크

케이뱅크

수협

대구

부산

광주

전북

경남

제주

새마을

신협

우체국

삼성카드

신한카드

현대카드

KB국민카드

롯데카드

우리카드

하나카드

BC카드

NH카드

씨티카드

홈택스

+47

78+ 금융기관. 하나의 API.

// security

보안은 기능이 아니라 전제입니다.

AES-256 암호화

모든 민감 데이터는 AES-256으로 암호화하여 저장합니다.

인증서 격리 저장

인증 정보는 격리된 저장소에서 암호화 상태로 관리됩니다.

Live/Sandbox 환경 분리

개발과 운영 환경을 완전히 분리하여 안전하게 테스트합니다.

API 키 기반 접근 제어

API 키 단위로 권한과 호출량을 세밀하게 제어합니다.

// deep dive

클로드로 우리 회사의 재무 데이터를 분석하려면?

매일 아침 홈택스와 은행 사이트에서 엑셀을 다운로드하던 시대는 끝났습니다. 이제 채팅 한 줄이면 우리 회사의 모든 재무 데이터를 실시간으로 연결할 수 있습니다.

“은행마다 인증 방식이 다르고, 카드사마다 응답 포맷이 다르다. 3개월에서 6개월을 연동에 쏟고도 유지보수에 허덕이는 팀을 수없이 봐왔다. 이 인프라를 모든 팀이 매번 새로 만드는 건 낭비라는 것을 확신하게 됐다.”

금융 데이터, 하나의 API로 — Headless Finance Platform을 공개합니다

dataportal.kr

// developer experience

5분이면 첫 API 호출

익숙한 언어로 시작하세요. 복잡한 설정 없이 바로 연동할 수 있습니다.

terminal

curl -X POST https://api.h6s.ai/v1/data-jobs \
  -H "Authorization: Bearer h6s_live_..." \
  -d '{"connector_id": "conn_01", "action": "bank.transactions"}'

index.ts

import { Headless } from "@headless-finance/sdk";

const headless = new Headless("h6s_live_...");

const job = await headless.dataJobs.create({
  connectorId: "conn_01",
  action: "bank.transactions",
  dateRangeStart: "2026-03-01",
  dateRangeEnd: "2026-03-31",
});

const results = await job.waitForCompletion();
console.log(results.data);

main.py

from headless_finance import HeadlessClient

client = HeadlessClient("h6s_live_...")

job = client.data_jobs.create(
    connector_id="conn_01",
    action="bank.transactions",
    date_range_start="2026-03-01",
    date_range_end="2026-03-31",
)

results = job.wait_for_completion()
print(results.data)

Main.java

import ai.h6s.HeadlessClient;
import ai.h6s.model.DataJob;
import ai.h6s.model.DataJobResult;

HeadlessClient client = HeadlessClient.builder()
    .apiKey("h6s_live_...")
    .build();

DataJob job = client.dataJobs().create(
    CreateDataJobRequest.builder()
        .connectorId("conn_01")
        .action("bank.transactions")
        .dateRangeStart("2026-03-01")
        .dateRangeEnd("2026-03-31")
        .build()
);

DataJobResult results = job.waitForCompletion();
System.out.println(results.getData());

Main.kt

import ai.h6s.HeadlessClient

val client = HeadlessClient("h6s_live_...")

val job = client.dataJobs.create {
    connectorId = "conn_01"
    action = "bank.transactions"
    dateRangeStart = "2026-03-01"
    dateRangeEnd = "2026-03-31"
}

val results = job.waitForCompletion()
println(results.data)

main.go

package main

import "github.com/h6s-ai/headless-go"

func main() {
    client := headless.NewClient("h6s_live_...")

    job, _ := client.DataJobs.Create(&headless.CreateDataJobParams{
        ConnectorID:    "conn_01",
        Action:         "bank.transactions",
        DateRangeStart: "2026-03-01",
        DateRangeEnd:   "2026-03-31",
    })

    results, _ := job.WaitForCompletion()
    fmt.Println(results.Data)
}

// pricing

Pricing

Free

₩0/월

무제한 API 키
무제한 커넥터
월 100회 API 호출
커뮤니티 지원

Enterprise

커스텀

무제한 API 호출
SLA 보장
전담 지원
전담 엔지니어 배정

headless

Get an invite

소수의 팀에게만 먼저 초대하고 있습니다.

Financial data,headless.

Why headless

Unified Endpoint

Standardized Schema

AI Classification

기존 API와 다릅니다

운영 부담 제로

접근 정보, 철저하게 보호합니다

코드 변경 없이 확장

원하는 방식으로 연동하세요

Simple API

How it works

Connect

Collect

Normalize

78+ 금융기관

보안은 기능이 아니라 전제입니다.

AES-256 암호화

인증서 격리 저장

Live/Sandbox 환경 분리

API 키 기반 접근 제어

클로드로 우리 회사의 재무 데이터를 분석하려면?

5분이면 첫 API 호출

Pricing

Free

Enterprise

Get an invite

Simple API

Financial data,
headless.