curl -X POST https://24plus.ai.kr/api/v1/cafe/fortune_data \
  -H "X-API-Key: pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":"199001151030","gender":1,"period":"yl"}'

# 방법 1: X-API-Key 헤더 (권장)
curl -H "X-API-Key: pk_live_your_api_key_here" ...

# 방법 2: Bearer Token
curl -H "Authorization: Bearer pk_live_your_api_key_here" ...

API 키는 서버 사이드에서만 사용하세요. 클라이언트(브라우저, 앱)에 노출하면 안 됩니다. 키가 노출된 경우 즉시 관리자에게 폐기를 요청하세요.

파트너 설정에서 auth_type을 'api_key_ip'로 설정하면 등록된 IP에서만 API를 호출할 수 있습니다. 프로덕션 환경에서 권장합니다.

# API 목록 조회 (인증 불필요)
GET /api/v1/cafe/_list
→ { "tools": ["fortune_data","fortune_reading","cafe_ncode","daily_fortune",...] }

{
  "result": { ... },              // CAFE 엔진 분석 결과
  "usage": {
    "rpm_remaining": 58,           // 분당 잔여
    "rpd_remaining": 9945,         // 일당 잔여
    "monthly_remaining": 298721    // 월당 잔여
  },
  "meta": {
    "function": "fortune_data",       // 호출된 MCP 도구
    "response_time_ms": 142,       // 응답 시간 (ms)
    "partner": "dangamsoft"        // 파트너 코드
  }
}

Core Analysis (2)

Fortune Service (1)

Personality & Compatibility (2)

Naming & Search (3)

// 일반 에러
{ "error": "Rate limit exceeded: 60 RPM" }

// CAFE 엔진 에러
{ "error": "CAFE engine error", "detail": { ... } }

import requests

API_KEY = "pk_live_your_api_key_here"
BASE_URL = "https://24plus.ai.kr/api/v1/cafe"

def call_cafe(func_name, params):
    resp = requests.post(
        f"{BASE_URL}/{func_name}",
        headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
        json=params, timeout=30,
    )
    resp.raise_for_status()
    return resp.json()

# 사주 기본 정보
result = call_cafe("fortune_data", {
    "birth": "199001151030", "gender": 1, "period": "yl",
})
print(result["result"])
print(f"RPM 잔여: {result['usage']['rpm_remaining']}")

# 관계분석
compat = call_cafe("compatibility", {
    "birth": "199001151030", "gender": 1,
    "rel_birth": "199205201400", "rel_gender": 0,
})

const API_KEY = "pk_live_your_api_key_here";
const BASE_URL = "https://24plus.ai.kr/api/v1/cafe";

async function callCafe(funcName, params) {
  const res = await fetch(`${BASE_URL}/${funcName}`, {
    method: "POST",
    headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify(params),
    signal: AbortSignal.timeout(30000),
  });
  if (!res.ok) {
    const err = await res.json();
    throw new Error(`${res.status}: ${err.error}`);
  }
  return res.json();
}

// 오늘의 운세
const fortune = await callCafe("daily_fortune", {
  birth: "199001151030", gender: 1, scope: "total",
});

// 작명
const names = await callCafe("naming", {
  birth: "202401150800", gender: 0, family_name: "김",
});

import requests
from time import sleep

def call_with_retry(func_name, params, max_retries=3):
    for attempt in range(max_retries):
        try:
            resp = requests.post(
                f"{BASE_URL}/{func_name}",
                headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
                json=params, timeout=30,
            )
            if resp.status_code == 429:
                retry_after = int(resp.headers.get("Retry-After", 60))
                sleep(retry_after)
                continue
            if resp.status_code in (502, 504):
                sleep(2 ** attempt)
                continue
            resp.raise_for_status()
            return resp.json()
        except requests.Timeout:
            if attempt == max_retries - 1: raise
    raise Exception("Max retries exceeded")