Skip to main content
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/usageAPI 사용량
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