돌아가기

Developer API

프랜차이즈 파트너를 위한 보드게임 AI 봇 연동 가이드입니다.
간단한 API 호출로 태블릿 메뉴판에 강력한 AI 룰 서포터를 탑재하세요.

1인증 (Authentication)

모든 API 요청은 헤더에 x-api-key를 포함해야 합니다.
API 키는 제휴 계약 체결 후 발급됩니다.

x-api-key: franchise_sample_key_12345

2엔드포인트 (Endpoints)

POST/api/external/chat
AI 룰 질문

Request Body (JSON)

// JavaScript / Node.js 예제
const response = await fetch('https://www.bgmasterai.com/api/external/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY' // 발급받은 키 입력
  },
  body: JSON.stringify({
    messages: [
      { role: "user", content: "할리갈리 룰 알려줘" }
    ]
  })
});

const data = await response.json();
console.log(data);

Response (JSON)

{
  "success": true,
  "data": {
    "sections": {
      "summary": {
        "title": "핵심 요약",
        "content": "할리갈리는 과일이 5개가 되면 종을 치는 게임입니다."
      },
      "detail": {
        "title": "설명",
        "content": "카드를 한 장씩 뒤집다가..."
      },
      "caution": {
        "title": "주의/예외",
        "content": "종을 잘못 치면 내 카드를 한 장씩 나눠줘야 합니다."
      }
    },
    "full_text": "### 핵심 요약\n..." // 원본 텍스트
  }
}

3주요 기능

RAG 기반 룰 검색

할루시네이션(거짓 답변)을 최소화하기 위해 검증된 룰북 DB를 검색하여 답변합니다.

구조화된 답변 데이터

단순 텍스트뿐만 아니라, 핵심요약/주의사항 등 섹션별로 분리된 JSON 데이터를 제공하여 UI 커스터마이징이 용이합니다.

API 도입 문의

API 키 발급 및 제휴 문의는 아래 메일로 연락주시면담당 개발자가 영업일 기준 24시간 이내에 답변드립니다.

문의하기