Skip to main content
GET
/
v1
/
profiles
/
{id}
/
unmasked
프로필 복호화 조회
curl --request GET \
  --url https://sajuapi.dev/v1/profiles/{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입니다. prf_ 접두사로 시작합니다.

​
Response

​
성공

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

​
실패

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

​
요청 예시

curl -X GET https://api.sajuapi.dev/v1/profiles/prf_abc123def456/unmasked \
  -H "X-API-Key: bs_live_xxx"

​
응답 예시

{
  "id": "prf_abc123def456",
  "external_id": "user_12345",
  "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": "경",
        "stem_hanja": "庚",
        "branch": "오",
        "branch_hanja": "午",
        "element": "metal"
      },
      "month": {
        "stem": "기",
        "stem_hanja": "己",
        "branch": "묘",
        "branch_hanja": "卯",
        "element": "earth"
      },
      "day": {
        "stem": "병",
        "stem_hanja": "丙",
        "branch": "인",
        "branch_hanja": "寅",
        "element": "fire"
      },
      "hour": {
        "stem": "을",
        "stem_hanja": "乙",
        "branch": "미",
        "branch_hanja": "未",
        "element": "wood"
      }
    },
    "day_master": {
      "name": "병화",
      "hanja": "丙火",
      "element": "fire",
      "description": "태양과 같은 밝고 뜨거운 기운을 가진 일주입니다."
    },
    "elements": {
      "wood": 2,
      "fire": 3,
      "earth": 1,
      "metal": 1,
      "water": 1
    },
    "weakest_element": "water",
    "strongest_element": "fire"
  },
  "created_at": "2025-01-15T09:00:00Z",
  "updated_at": "2025-01-15T09:00:00Z"
}

​
Unmasked Profile 객체

일반 Profile 조회와 달리 다음 필드가 원본 값으로 반환됩니다.
필드타입설명
namestring사용자 이름 원본입니다. (마스킹 없음)
birth_yearinteger출생 연도 원본입니다.
birth_monthinteger출생 월 원본입니다.
birth_dayinteger출생 일 원본입니다.
birth_hourinteger출생 시 원본입니다. 값이 없으면 null입니다.
sajuobject완전한 사주팔자 정보입니다.

​
Saju 객체

필드타입설명
pillarsobject사주(四柱) 정보입니다. 연주, 월주, 일주, 시주를 포함합니다.
pillars.yearobject연주(年柱) 정보입니다.
pillars.monthobject월주(月柱) 정보입니다.
pillars.dayobject일주(日柱) 정보입니다.
pillars.hourobject시주(時柱) 정보입니다. birth_hour가 없으면 null입니다.
day_masterobject일간(日干) 정보입니다.
elementsobject오행별 분포입니다.
weakest_elementstring가장 약한 오행입니다.
strongest_elementstring가장 강한 오행입니다.

​
감사 로그

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