v1 마이그레이션 가이드

{
  "saju": {
    "pillars": { ... },
    "dayMaster": { ... }
  },
  "userName": "김철수",
  "model": "haiku"
}

{
  "profile_id": "prf_abc123",
  "type": "daily",
  "model": "haiku"
}

# 프로필 생성
curl -X POST https://api.sajuapi.dev/v1/profiles \
  -H "X-API-Key: bs_live_xxx" \
  -d '{
    "external_id": "user_12345",
    "name": "김철수",
    "birth_year": 1990,
    "birth_month": 3,
    "birth_day": 15,
    "birth_hour": 14,
    "gender": "male"
  }'

{
  "id": "prf_abc123",  // ← 이 ID를 저장
  "external_id": "user_12345",
  "day_master": "병화",
  ...
}

// 기존 코드 (제거)
const saju = SajuCalculator.calculate({
  year: birthYear,
  month: birthMonth,
  day: birthDay,
  hour: birthHour,
  gender: gender
});

// 신규 코드 (프로필 ID만 사용)
const profileId = "prf_abc123";

// 기존 코드
const response = await fetch('/api/daily-fortune', {
  method: 'POST',
  headers: { 'X-API-Key': API_KEY },
  body: JSON.stringify({
    saju: saju,
    userName: '김철수',
    model: 'haiku',
    date: '2025-01-15'
  })
});

// 신규 코드
const response = await fetch('/v1/fortunes', {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Idempotency-Key': `fortune-2025-01-15-${profileId}`
  },
  body: JSON.stringify({
    profile_id: profileId,
    type: 'daily',
    model: 'haiku',
    date: '2025-01-15'
  })
});

// 기존 응답
{
  "success": true,
  "data": {
    "character": { ... },
    "todayFortune": { ... }
  },
  "meta": { ... }
}

// 신규 응답
{
  "id": "ftn_xyz789",
  "profile_id": "prf_abc123",
  "type": "daily",
  "score": 78,
  "data": {
    "character": { ... },
    "today_fortune": { ... }  // camelCase → snake_case
  },
  "meta": { ... },
  "created_at": "2025-01-15T09:00:00Z"
}

POST /api/daily-fortune HTTP/1.1

HTTP/1.1 301 Moved Permanently
Location: /v1/fortunes
Deprecation: true
Sunset: 2025-06-30

npm update @sajuapi/sdk@latest

// 기존 SDK
import { getDailyFortune } from '@sajuapi/sdk';
const fortune = await getDailyFortune(saju, userName);

// 신규 SDK
import { SajuClient } from '@sajuapi/sdk';
const client = new SajuClient({ apiKey: API_KEY });

// 프로필 생성 (최초 1회)
const profile = await client.profiles.create({
  name: '김철수',
  birthYear: 1990,
  // ...
});

// 운세 조회
const fortune = await client.fortunes.create({
  profileId: profile.id,
  type: 'daily'
});

pip install --upgrade sajuapi

# 기존 SDK
from sajuapi import get_daily_fortune
fortune = get_daily_fortune(saju, user_name)

# 신규 SDK
from sajuapi import SajuClient
client = SajuClient(api_key=API_KEY)

# 프로필 생성 (최초 1회)
profile = client.profiles.create(
    name="김철수",
    birth_year=1990,
    # ...
)

# 운세 조회
fortune = client.fortunes.create(
    profile_id=profile.id,
    type="daily"
)