Skip to main content
GET
/
v1
/
fortunes
/
daily
/
{profile_id}
오늘의 운세 조회
curl --request GET \
  --url https://sajuapi.dev/v1/fortunes/daily/{profile_id} \
  --header 'X-API-Key: <api-key>'

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.

v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
특정 프로필의 오늘 운세를 조회합니다. 오늘 생성된 운세가 없으면 자동으로 생성됩니다.
이 엔드포인트는 오늘의 운세를 간편하게 조회하기 위한 단축 API입니다. 운세가 없으면 haiku 모델로 자동 생성됩니다. 다른 모델을 사용하려면 운세 생성 엔드포인트를 사용하세요.

​
Path 파라미터

​
profile_id
string
required
운세를 조회할 프로필의 ID입니다. prf_ 접두사로 시작합니다.

​
Query 파라미터

​
auto_generate
boolean
default:"true"
오늘의 운세가 없을 때 자동으로 생성할지 여부입니다. false로 설정하면 운세가 없을 때 404를 반환합니다.
​
model
string
default:"haiku"
자동 생성 시 사용할 AI 모델입니다. auto_generate가 true일 때만 적용됩니다.

​
Response

​
성공

오늘의 운세 조회에 성공하면 Fortune 객체가 반환됩니다.

​
실패

상태 코드에러 타입설명
401authentication_errorAPI 키가 유효하지 않음
404not_found프로필을 찾을 수 없거나, auto_generate=false이고 오늘의 운세가 없음
429rate_limited요청 한도 초과
503service_unavailableAI 모델 서비스 일시 불가 (자동 생성 시)

​
요청 예시

# 기본 요청 (자동 생성 활성화)
curl -X GET https://api.sajuapi.dev/v1/fortunes/daily/prf_abc123def456 \
  -H "X-API-Key: bs_live_xxx"

# 자동 생성 비활성화
curl -X GET "https://api.sajuapi.dev/v1/fortunes/daily/prf_abc123def456?auto_generate=false" \
  -H "X-API-Key: bs_live_xxx"

# 자동 생성 시 sonnet 모델 사용
curl -X GET "https://api.sajuapi.dev/v1/fortunes/daily/prf_abc123def456?model=sonnet" \
  -H "X-API-Key: bs_live_xxx"

​
응답 예시

{
  "id": "ftn_xyz789abc123",
  "profile_id": "prf_abc123def456",
  "fortune_type": "daily",
  "fortune_date": "2025-01-16",
  "model": "haiku",
  "score": 78,
  "summary": "오늘은 안정적인 하루가 예상됩니다. 급한 결정은 피하고 차분하게 하루를 보내세요.",
  "categories": {
    "overall": {
      "score": 78,
      "description": "무난한 하루가 예상됩니다."
    },
    "wealth": {
      "score": 70,
      "description": "재물운은 평범합니다."
    },
    "love": {
      "score": 82,
      "description": "가까운 사람과의 관계가 좋습니다."
    },
    "health": {
      "score": 75,
      "description": "충분한 휴식이 필요합니다."
    },
    "career": {
      "score": 80,
      "description": "업무가 순조롭게 진행됩니다."
    }
  },
  "lucky_items": {
    "number": 3,
    "color": "파랑",
    "direction": "동쪽",
    "time": "오전 10시-12시"
  },
  "advice": "오늘은 새로운 도전보다 기존 일에 집중하세요.",
  "cached": true,
  "generated_at": "2025-01-16T00:05:00Z"
}

​
자동 생성 동작

auto_generate=true(기본값)일 때:
  1. 오늘 날짜의 운세가 이미 존재하면 캐시된 결과 반환
  2. 운세가 없으면 지정된 모델로 새로 생성
  3. 생성된 운세는 자동으로 저장되어 다음 요청 시 캐시됨
요청 → 오늘 운세 있음? → 있으면 반환
                    ↓
                 없으면
                    ↓
              운세 생성 (haiku)
                    ↓
                저장 후 반환

​
타임존

운세 날짜는 한국 표준시(KST, UTC+9) 기준입니다. 매일 자정(KST)에 새로운 날의 운세가 생성됩니다. 
2025-01-16 00:00 KST = 2025-01-15 15:00 UTC