v2 API 개요

v2 API는 기업 고객을 위한 Enterprise 기능을 제공합니다.

v2 API는 아직 개발 중입니다. 현재 사용 가능한 API는 v1을 참고하세요.

특징

프로필 관리: 사용자 프로필 CRUD 및 다중 프로필 지원
운세 저장: 생성된 운세 저장, 조회, 삭제
웹훅: 이벤트 기반 알림 시스템
리포트: 사용량, 비용, 감사 로그
데이터 마스킹: PII 보호 (Enterprise)
Rate Limiting: 플랜별 요청 제한
Idempotency: 안전한 재시도

API 카테고리

프로필 (Profiles)

엔드포인트	설명
`POST /v2/profiles`	프로필 생성
`GET /v2/profiles`	프로필 목록
`GET /v2/profiles/:id`	프로필 조회
`PATCH /v2/profiles/:id`	프로필 수정
`DELETE /v2/profiles/:id`	프로필 삭제
`GET /v2/profiles/:id/unmasked`	마스킹 해제 조회

운세 (Fortunes)

엔드포인트	설명
`POST /v2/fortunes`	운세 생성
`GET /v2/fortunes`	운세 목록
`GET /v2/fortunes/:id`	운세 조회
`DELETE /v2/fortunes/:id`	운세 삭제
`POST /v2/fortunes/batch`	배치 생성
`POST /v2/fortunes/stream`	스트리밍 생성

웹훅 (Webhooks)

엔드포인트	설명
`POST /v2/webhooks`	웹훅 생성
`GET /v2/webhooks`	웹훅 목록
`GET /v2/webhooks/:id`	웹훅 조회
`DELETE /v2/webhooks/:id`	웹훅 삭제
`POST /v2/webhooks/:id/test`	웹훅 테스트

리포트 (Reports)

엔드포인트	설명
`GET /v2/reports/usage`	API 사용량
`GET /v2/reports/fortunes`	운세 통계
`GET /v2/reports/profiles`	프로필 통계
`GET /v2/reports/audit`	감사 로그

Enterprise 기능

데이터 마스킹

기본적으로 모든 PII(개인식별정보)는 마스킹됩니다:

{
  "birthDate": "19**-**-**",
  "name": "김*"
}

/unmasked 엔드포인트로 원본 데이터 조회 가능 (권한 필요).

감사 로그

모든 API 호출이 기록됩니다:

{
  "timestamp": "2026-01-20T10:30:00Z",
  "action": "profile.created",
  "actor": { "type": "api_key", "id": "..." },
  "resource": { "type": "profile", "id": "..." }
}

요금제

플랜	가격	요청 제한	기능
Pro	$99/월	10,000/일	기본 기능
Business	$299/월	100,000/일	+ 웹훅, 리포트
Enterprise	문의	무제한	+ 데이터 마스킹, 감사 로그, SLA

API 레퍼런스

프로필

운세

계산

웹훅

리포트

시스템

엔터프라이즈

특징

API 카테고리

프로필 (Profiles)

운세 (Fortunes)

웹훅 (Webhooks)

리포트 (Reports)

Enterprise 기능

데이터 마스킹

감사 로그

요금제

​특징

​API 카테고리

​프로필 (Profiles)

​운세 (Fortunes)

​웹훅 (Webhooks)

​리포트 (Reports)

​Enterprise 기능

​데이터 마스킹

​감사 로그

​요금제

특징

API 카테고리

프로필 (Profiles)

운세 (Fortunes)

웹훅 (Webhooks)

리포트 (Reports)

Enterprise 기능

데이터 마스킹

감사 로그

요금제