matcha-logic/kitchen
Developer Specification

Open API Infusions.

말차 로직 다실이 개방하는 실시간 차(Tea) 우림 API 엔드포인트 목록 및 규격 문서입니다. 상세 응답 명세를 확인하고 직접 실시간 샌드박스 요청을 보내볼 수 있습니다.

실시간 API 요청 워크벤치

원하는 엔드포인트 파일 경로를 직접 텍스트로 타이핑하여 호출하고 응답 결과를 테스트해 볼 수 있습니다. (예: matcha, sencha, hojicha, coffee)

GET/api/brew/.json
matcha.jsonsencha.jsonhojicha.jsoncoffee.json

블로그 포스팅 통계 조회 API

MatchaLogic에 작성된 전체 블로그 포스트의 통계와 함께, 가장 최근 발행된 포스트의 제목, 발행일, 요약 설명을 포함한 메타데이터를 진하고 묵직한 형태로 우려냅니다.

/api/brew/matcha.json
matcha statistics
example value
                          {
  "status": 200,
  "drink": "matcha",
  "flavor_depth": "Deep & Heavy (100% Full Leaf)",
  "message": "진하게 우려낸 MatchaLogic의 핵심 포스팅 통계 데이터입니다. 🍵",
  "statistics": {
    "totalPosts": 19,
    "latestPost": {
      "title": "말차 로직 3.0: 4인 체제 개편과 AI 협업 가이드라인 확립",
      "publishDate": "2026-08-01",
      "description": "신규 크루 Claude 합류에 맞춰 설계한 새로운 AI 협업 워크플로우와 버전 표기 규칙을 소개합니다."
    }
  }
}

시스템 업데이트 로그 조회 API

MatchaLogic의 전체 시스템 변경 이력(Changelog)의 통계와 함께, 최신 업데이트 기록(버전, 날짜, 유형, 한 줄 요약)을 산뜻하고 투명한 맛으로 정리하여 제공합니다.

/api/brew/sencha.json
sencha updates log
example value
                          {
  "status": 200,
  "drink": "sencha",
  "flavor_depth": "Light & Refreshing (75% Crisp)",
  "message": "산뜻하게 정리된 MatchaLogic의 시스템 업데이트 로그입니다. 🍃",
  "statistics": {
    "totalUpdates": 54,
    "latestUpdate": {
      "version": "3.4.1",
      "date": "2026-08-30",
      "title": "반응형 모바일 햄버거 메뉴 탑재 및 Privacy 페이지 브랜드 일러스트 추가",
      "type": "feature"
    }
  }
}

기술 스택 및 아키텍처 조회 API

MatchaLogic의 다실(茶室)을 구동하기 위해 사용된 호스팅, 프레임워크, 스타일링 라이브러리 및 서버리스 기술 명세를 고소하고 아늑한 풍미로 출력합니다.

/api/brew/hojicha.json
hojicha tech stack
example value
                          {
  "status": 200,
  "drink": "hojicha",
  "flavor_depth": "Roasted & Cozy (50% Warm)",
  "message": "구수하게 볶아낸 MatchaLogic의 Kitchen 아키텍처 스펙입니다. 🍂",
  "techStack": {
    "hosting": "Cloudflare Pages",
    "styling": "Tailwind CSS",
    "framework": "Astro v7.0.9",
    "serverless": "Cloudflare Pages Functions",
    "language": "TypeScript"
  }
}

커피 추출 요청 API

서버가 커피 추출 명령을 전달받았을 때의 동작을 확인합니다. 본 서버는 차(Tea) 전용 엔진으로 구성되어 있으므로, 418 I'm a teapot 규격 에러와 관련 메타데이터를 반환합니다.

/api/brew/coffee.json
coffee error simulated
example value
                          {
  "status": 418,
  "error": "418 I'm a teapot",
  "message": "MatchaLogic is a teapot. We only brew tea, not coffee! 🫖",
  "flavor_depth": "None (0% - Teapot Exception)",
  "drink": "coffee"
}
Back to /kitchen