명운 API 🔮

별자리·띠별 오늘의 운세를 JSON으로 내려주는 API와 챗봇 연동 안내입니다. 현재 무료 테스트 단계예요.

1. 텔레그램 봇 (가장 쉬움)

텔레그램에서 명운 운세 봇을 추가하고 /구독 하면, 매일 아침 9시에 오늘의 별자리 운세를 자동으로 보내드려요.

· 구독 — 매일 아침 운세 받기
· 해지 — 그만 받기
· 사자자리 / 쥐띠 — 원하는 운세 바로 보기

👉 텔레그램 봇 열기 준비 중

2. REST API

인증 헤더 Authorization: Bearer <API_KEY> 로 호출합니다.

# 오늘의 별자리 12개
GET /fortune?type=star

# 특정 별자리 (aries, taurus, ... capricorn)
GET /fortune?type=star&sign=leo

# 오늘의 띠별 12개
GET /fortune?type=zodiac

# 특정 띠 (rat, ox, ... pig)
GET /fortune?type=zodiac&animal=rat

응답은 명운 앱의 오늘의 운세와 동일한 값(날짜 시드 기반)입니다.

{
  "date": "2026-07-06",
  "type": "star",
  "results": [
    { "sign":"aquarius", "name":"물병자리", "range":"01.20~02.18",
      "fortune":"...", "lucky":{ "item":"반지","color":"검정","number":25 } }
  ]
}

3. 이용·문의

API 키 발급·제휴 문의는 카카오톡 채널로 연락 주세요. 정식 요금제는 추후 안내됩니다.

← 명운 홈으로
© 2026 체인커머스