의존성 없이 돌아가는 만세력 API 호출 예제를 MIT로 공개했어요 (curl · Node · Python)

안녕하세요. 플로트 주식회사(FLOAT)에서 사주·운세 API 서비스 흐름(HRUM)을 만들고 있어요. 저희 서비스의 예제 저장소라 소속부터 밝힙니다.

API 예제를 보면 SDK 설치부터 시키는 경우가 많아서, 반대로 아무것도 설치하지 않고 읽고 돌릴 수 있는 예제를 만들어 공개했어요.

저장소: https://github.com/float1122/hrum-manseryeok-example (MIT)

들어 있는 것

• curl.sh — curl 하나로 호출하는 셸 스크립트
• manseryeok.mjs — Node 내장 fetch만 써요. npm install이 필요 없어요
• manseryeok.py — Python 표준 라이브러리 urllib만 써요. pip install이 필요 없어요
• mock/server.mjs — 예시 응답을 돌려주는 로컬 목 서버. 진짜 키 없이도 코드 흐름을 따라가 볼 수 있어요
• test/ — 목 서버와 고정 응답(fixture)으로 도는 테스트

만들면서 신경 쓴 것

• 키는 환경변수 HRUM_API_KEY에서만 읽고, .env는 .gitignore에 넣어 두었어요
• Python urllib의 기본 User-Agent는 저희 앞단 보안 규칙에 막혀요. 그래서 예제에서 User-Agent를 직접 지정하고, 막혔을 때 그 이유를 한국어로 알려 주게 했어요. 같은 문제로 헤매는 분이 있을 것 같아 적어 둡니다
• 출생 시각을 모르면 시각 필드를 빼고 보내면 돼요. 그러면 시주 없이 나머지 기둥으로 계산돼요

API 쪽 이야기는 짧게

흐름은 만세력·궁합 계산과 AI 리딩을 API로 제공하는 상용 서비스예요. 예제를 실제 API로 돌리려면 콘솔에서 키를 발급받아야 해요. 예제 코드 자체는 MIT라 다른 API 호출 예제의 틀로 가져다 쓰셔도 돼요.

• API 문서: https://hrum.ai/docs.html#saju-api

이슈로 남겨 주시면 확인할게요.