Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sajuapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

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