API 개요

https://api.sajuapi.dev

curl -X POST https://api.sajuapi.dev/api/daily-fortune \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bs_live_xxx" \
  -d '{"saju": {...}, "userName": "홍길동"}'

{
  "success": true,
  "data": {
    // 엔드포인트별 데이터
  },
  "meta": {
    "requestId": "req_abc123",
    "model": "haiku",
    "cached": true,
    "cost": 0.013,
    "latency": 1234
  }
}

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "사람이 읽을 수 있는 에러 메시지",
    "hint": "에러 수정을 위한 제안",
    "field": "saju.pillars.day"  // 선택: 에러가 발생한 특정 필드
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

interface Saju {
  pillars: {
    year: Pillar;
    month: Pillar;
    day: Pillar;
    hour: Pillar;  // 출생 시간을 모르면 null 가능
  };
  dayMaster?: {
    element: 'wood' | 'fire' | 'earth' | 'metal' | 'water';
    name: string;  // 예: "병화"
  };
}

interface Pillar {
  stem: {
    hangul: string;  // 예: "갑", "을", "병"...
    hanja?: string;  // 예: "甲", "乙", "丙"...
  };
  branch: {
    hangul: string;  // 예: "자", "축", "인"...
    hanja?: string;
  };
}

{
  "saju": {...},
  "userName": "홍길동",
  "model": "haiku"
}

{
  "page": 1,
  "limit": 20,
  "sort": "createdAt",
  "order": "desc"
}

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}

https://api.sajuapi.dev/v1/api/daily-fortune