사주·타로 API

지금 열려 있는 엔드포인트 21개

각 엔드포인트의 요청 필드·응답 모양·상태 코드는 API 문서에 있습니다.

60초 예제

키도 헤더도 필요 없습니다. 아래를 그대로 붙여 넣으면 됩니다.

curl -X POST https://api.manse.app/v1/saju/calculate \
  -H 'content-type: application/json' \
  -d '{"year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "M"}'

실제 응답에서 일주 한 칸과 관계 한 짝만 추린 모습입니다. 나머지 세 기둥도 같은 모양이고, 오행·용신·격국·신살·대운이 함께 옵니다.

{
  "ok": true,
  "data": {
    "pillars": {
      "day": {
        "stem": {
          "key": "gyeong",
          "hanja": "庚",
          "label": "경",
          "ordinal": 6,
          "element": {
            "key": "metal",
            "label": "금"
          },
          "polarity": {
            "key": "yang",
            "label": "양"
          }
        },
        "branch": {
          "key": "jin",
          "hanja": "辰",
          "label": "진",
          "ordinal": 4,
          "element": {
            "key": "earth",
            "label": "토"
          },
          "polarity": {
            "key": "yang",
            "label": "양"
          }
        },
        "ten_god": {
          "stem": {
            "key": "ilgan",
            "label": "일간"
          },
          "branch": {
            "key": "pyeonin",
            "label": "편인"
          }
        },
        "hidden_stems": [
          {
            "stem": {
              "key": "eul",
              "hanja": "乙",
              "label": "을",
              "ordinal": 1,
              "element": {
                "key": "wood",
                "label": "목"
              },
              "polarity": {
                "key": "yin",
                "label": "음"
              }
            },
            "role": {
              "key": "yeogi",
              "label": "여기"
            }
          },
          {
            "stem": {
              "key": "gye",
              "hanja": "癸",
              "label": "계",
              "ordinal": 9,
              "element": {
                "key": "water",
                "label": "수"
              },
              "polarity": {
                "key": "yin",
                "label": "음"
              }
            },
            "role": {
              "key": "junggi",
              "label": "중기"
            }
          },
          {
            "stem": {
              "key": "mu",
              "hanja": "戊",
              "label": "무",
              "ordinal": 4,
              "element": {
                "key": "earth",
                "label": "토"
              },
              "polarity": {
                "key": "yang",
                "label": "양"
              }
            },
            "role": {
              "key": "jeonggi",
              "label": "정기"
            }
          }
        ],
        "life_stage": {
          "key": "yang",
          "label": "양"
        },
        "napeum": {
          "key": "baekrapgeum",
          "label": "백랍금",
          "element": {
            "key": "metal",
            "label": "금"
          }
        },
        "is_void": false,
        "twelve_sinsal": {
          "key": "wolsal",
          "label": "월살"
        },
        "twelve_sinsal_by_day": {
          "key": "hwagaesal",
          "label": "화개살"
        },
        "palace": {
          "key": "bonin_baeuja",
          "label": "본인·배우자"
        },
        "root": null
      },
      "...": "..."
    },
    "relations": {
      "pairs": [
        {
          "between": [
            "year",
            "hour"
          ],
          "stem": null,
          "branch": [
            {
              "key": "yukhap",
              "label": "육합"
            }
          ],
          "resolution": null
        }
      ],
      "...": "..."
    },
    "...": "..."
  },
  "meta": {
    "...": "..."
  }
}

요금

지금 상태를 그대로 적습니다. v1 은 키가 필요합니다(/v1/meta 만 키 없이 열려 있습니다). 사용량은 저희가 직접 세고, 남은 양은 GET /v1/me 로 확인하실 수 있습니다 (이 호출은 사용량으로 세지 않습니다). 한도를 다 쓰면 그 기간에만 제한되고 넘겼다고 추가로 청구하지 않습니다. 기업 요금제는 미리 정해 둔 숫자가 없습니다 — 필요한 규모를 메일로 알려 주시면 한도를 정해 쓰시던 키에 그대로 적용합니다.

버전과 호환

공개 v1 은 깨지 않고 더하기만 합니다. 필드가 추가될 수는 있어도 기존 필드가 사라지거나 뜻이 바뀌지 않습니다. 지금 라이브가 밝히는 버전은 이렇습니다.

{
  "api_version": "v1",
  "engine": {
    "saju": {
      "version": "1.0.0",
      "contract": "6aae7228"
    },
    "tarot": {
      "version": "1.1.0",
      "contract": "bb408443"
    }
  },
  "data_version": {
    "bundled": "d9b91453",
    "tarot_kv": "24b4e6aa",
    "saju_kv": "bb37bd0f"
  }
}

data_version 이 바뀌면 해석 데이터가 갱신된 것이고, engine.*.contract 가 바뀌면 계산 계약이 움직인 것입니다. 두 값은 서로 다른 뜻이라 따로 밝힙니다. 언제나 /v1/meta 가 현재 값을 알려 줍니다.

API 문서 보기 도입 문의