Skip to main content
GET
https://sajuapi.dev
/
v1
/
fortunes
/
{id}
운세 조회
curl --request GET \
  --url https://sajuapi.dev/v1/fortunes/{id} \
  --header 'X-API-Key: <api-key>'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
특정 운세의 상세 정보를 조회합니다. 민감한 프로필 정보는 마스킹되어 반환됩니다.
마스킹되지 않은 원본 데이터가 필요한 경우 운세 복호화 조회 엔드포인트를 사용하세요.

Path 파라미터

id
string
required
조회할 운세의 ID입니다. ftn_ 접두사로 시작합니다.

Response

성공

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

실패

상태 코드에러 타입설명
401authentication_errorAPI 키가 유효하지 않음
404not_found운세를 찾을 수 없음
429rate_limited요청 한도 초과

요청 예시

curl -X GET https://api.sajuapi.dev/v1/fortunes/ftn_xyz789abc123 \
  -H "X-API-Key: bs_live_xxx"

응답 예시

{
  "id": "ftn_xyz789abc123",
  "profile_id": "prf_abc123def456",
  "fortune_type": "daily",
  "fortune_date": "2025-01-16",
  "model": "sonnet",
  "score": 85,
  "summary": "오늘은 새로운 기회가 찾아오는 날입니다. 오행 중 화(火) 기운이 강해 창의적인 활동에 유리합니다.",
  "categories": {
    "overall": {
      "score": 85,
      "description": "전반적으로 긍정적인 하루가 예상됩니다."
    },
    "wealth": {
      "score": 75,
      "description": "재물운이 안정적입니다. 큰 지출은 피하세요."
    },
    "love": {
      "score": 90,
      "description": "인간관계가 원만합니다. 새로운 만남에 열린 마음을 가지세요."
    },
    "health": {
      "score": 80,
      "description": "건강은 양호하나 과로를 주의하세요."
    },
    "career": {
      "score": 88,
      "description": "업무에서 좋은 성과가 기대됩니다."
    }
  },
  "lucky_items": {
    "number": 7,
    "color": "빨강",
    "direction": "남쪽",
    "time": "오후 2시-4시"
  },
  "advice": "오늘은 적극적으로 행동하되, 중요한 결정은 신중하게 내리세요.",
  "profile": {
    "name": "김**",
    "day_master": "병화",
    "day_master_element": "fire"
  },
  "cached": false,
  "generated_at": "2025-01-16T09:00:00Z",
  "latency_ms": 2340
}

Fortune 객체

필드타입설명
idstring운세 ID입니다. ftn_ 접두사로 시작합니다.
profile_idstring연결된 프로필 ID입니다.
fortune_typestring운세 유형입니다.
fortune_datestring운세 날짜입니다.
modelstring사용된 AI 모델입니다.
scoreinteger전체 운세 점수입니다. 0-100 사이의 값입니다.
summarystring운세 요약입니다.
categoriesobject카테고리별 운세입니다.
lucky_itemsobject행운의 아이템입니다.
advicestring오늘의 조언입니다.
profileobject연결된 프로필 정보입니다. (마스킹됨)
cachedboolean캐시된 결과인지 여부입니다.
generated_atstring생성 시간입니다.
latency_msinteger응답 시간(밀리초)입니다.

Categories 객체

카테고리설명
overall전체 운세
wealth재물운
love애정운
health건강운
career직장/학업운
각 카테고리는 다음 필드를 포함합니다.
필드타입설명
scoreinteger카테고리 점수 (0-100)
descriptionstring카테고리별 상세 설명