Skip to main content
GET
/
v1
/
fortunes
/
{id}
/
unmasked
운세 복호화 조회
curl --request GET \
  --url https://sajuapi.dev/v1/fortunes/{id}/unmasked \
  --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를 사용하세요.
암호화된 운세 데이터를 복호화하여 원본 데이터를 조회합니다. 이 엔드포인트는 민감한 개인정보를 반환하므로 모든 요청이 감사 로그에 기록됩니다.
이 엔드포인트는 민감한 개인정보(프로필의 이름, 생년월일 등)를 평문으로 반환합니다. 모든 요청은 자동으로 감사 로그에 기록되며, 비정상적인 접근 패턴은 보안 검토 대상이 됩니다.

Path 파라미터

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

Response

성공

운세 복호화 조회에 성공하면 마스킹되지 않은 원본 데이터가 포함된 Fortune 객체가 반환됩니다.

실패

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

요청 예시

curl -X GET https://api.sajuapi.dev/v1/fortunes/ftn_xyz789abc123/unmasked \
  -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": {
    "id": "prf_abc123def456",
    "name": "김철수",
    "birth_year": 1990,
    "birth_month": 3,
    "birth_day": 15,
    "birth_hour": 14,
    "gender": "male",
    "day_master": "병화",
    "day_master_element": "fire",
    "weakest_element": "water",
    "saju": {
      "pillars": {
        "year": { "stem": "경", "branch": "오", "element": "metal" },
        "month": { "stem": "기", "branch": "묘", "element": "earth" },
        "day": { "stem": "병", "branch": "인", "element": "fire" },
        "hour": { "stem": "을", "branch": "미", "element": "wood" }
      },
      "elements": {
        "wood": 2,
        "fire": 3,
        "earth": 1,
        "metal": 1,
        "water": 1
      }
    }
  },
  "analysis": {
    "day_energy": "오늘의 일진은 갑인(甲寅)으로 목(木) 기운이 강합니다. 병화(丙火) 일주인 당신에게 목 기운은 생기를 불어넣어 창의력과 활력이 높아집니다.",
    "element_interaction": "본인의 화(火) 기운과 오늘의 목(木) 기운이 상생 관계를 이루어 긍정적인 에너지가 흐릅니다.",
    "recommendations": [
      "새로운 프로젝트를 시작하기 좋은 날입니다",
      "창의적인 활동에 집중하세요",
      "오후 시간대에 중요한 미팅을 잡으세요"
    ]
  },
  "cached": false,
  "generated_at": "2025-01-16T09:00:00Z",
  "latency_ms": 2340
}

마스킹 vs 비마스킹 비교

필드마스킹 (GET /fortunes/)비마스킹 (GET /fortunes//unmasked)
profile.name김**김철수
profile.birth_year19**1990
profile.birth_month-3
profile.birth_day-15
profile.birth_hour-14
profile.saju-완전한 사주 정보
analysis-상세 분석

감사 로그

모든 복호화 요청은 자동으로 감사 로그에 기록됩니다.
{
  "action": "fortune.unmasked",
  "resource_type": "fortune",
  "resource_id": "ftn_xyz789abc123",
  "actor_ip": "203.0.113.42",
  "actor_api_key": "bs_live_xxx...",
  "request_id": "req_xyz789",
  "metadata": {
    "profile_id": "prf_abc123def456"
  },
  "created_at": "2025-01-16T15:00:00Z"
}
복호화 요청 빈도가 비정상적으로 높은 경우 보안 알림이 발생할 수 있습니다. 필요한 경우에만 이 엔드포인트를 사용하고, 가능하면 마스킹된 데이터를 사용하세요.