문서

문서 API

마코노미 문서를 마크다운 원문으로 가져갑니다.

이 문서의 목차 (3)

지금 보고 계신 이 문서들을 그대로 가져가실 수 있습니다.
디스코드 봇에서 규정을 찾아주거나, 검색기를 만드실 때 쓰시면 됩니다.

문서 목록#

GET /v1/docs

키 불필요

curl "https://api.mcmi.kr/v1/docs?category=rules"

{
  "data": [
    {
      "path": "rules",
      "category": "rules",
      "title": "마코노미 규정",
      "description": "마코노미 서버의 규정을 안내해드립니다.",
      "tags": ["규정", "규칙"],
      "order": 1,
      "updated": "2026-08-22",
      "updatedBy": "나는리하"
    }
  ],
  "meta": {
    "count": 6,
    "categories": ["server", "server-api", "cooking", "donate", "enchant", "farming", "rules", "vending", "war"]
  }
}
변수설명
category카테고리로 거릅니다
tag태그로 거릅니다

문서 원문#

GET /v1/docs/{경로}

키 불필요

path 값을 그대로 붙이시면 됩니다.

curl https://api.mcmi.kr/v1/docs/rules

{
  "data": {
    "path": "rules",
    "title": "마코노미 규정",
    "content": "> [!WARNING]\n> 규정은 원칙적으로…"
  }
}

content 는 마크다운 원문입니다. 웹사이트에서 보이는 HTML이 아닙니다.

참고

본문에는 > [!WARNING] 같은 GFM 콜아웃과 :::cards 같은 마코노미 전용 문법이 섞여 있습니다.
디스코드에 그대로 붙이시면 문법이 그대로 보일 수 있으니, 필요하시면 걷어내고 쓰세요.

경고

운영 문서(개발자 독스 등 일부 카테고리)는 API로 나가지 않습니다.
웹사이트에서 보이는 문서와 개수가 다를 수 있습니다.

도움말

문서는 5분 캐시됩니다. 봇에서 규정을 자주 찾으신다면 여러분 쪽에서 한 번 더 캐시해 두시면 한도를 거의 쓰지 않으실 수 있습니다.

OpenAPI 스펙#

GET /v1/openapi.json

키 불필요

전체 엔드포인트 정의를 OpenAPI 3.1 형식으로 제공합니다.
이걸로 SDK를 자동 생성하실 수 있습니다.

npx @openapitools/openapi-generator-cli generate \
    -i https://api.mcmi.kr/v1/openapi.json \
    -g typescript-fetch -o ./mcmi-sdk

API 개요 · 인증과 한도

댓글

댓글은 마코노미 디스코드 서버 멤버만 쓸 수 있어요. 디스코드로 로그인