Developer Specification

Open API Infusions.

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

API Sandbox Workbench

실시간 API 요청 워크벤치

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

GET/api/brew/.json
GET/api/brew/matcha.json

블로그 포스팅 통계 조회 API

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

우려낸 결과

CodeDescription
200

Matcha statistics successfully retrieved.

Example Value (application/json)
                            {
  "status": 200,
  "drink": "matcha",
  "flavor_depth": "Deep & Heavy (100% Full Leaf)",
  "message": "진하게 우려낸 MatchaLogic의 핵심 포스팅 통계 데이터입니다. 🍵",
  "statistics": {
    "totalPosts": 18,
    "latestPost": {
      "title": "말차를 우리는 API: 서버리스로 구현하는 찻주전자 에러와 이스터에그",
      "publishDate": "2026-07-25",
      "description": "418 에러 코드를 가볍게 구현해보고 싶다는 작은 생각에서 시작해, 실시간 API 테스터 개발과 트래픽 과부하 방지까지 설계하게 된 개발 과정."
    }
  }
}
GET/api/brew/sencha.json

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

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

우려낸 결과

CodeDescription
200

Sencha updates log successfully retrieved.

Example Value (application/json)
                            {
  "status": 200,
  "drink": "sencha",
  "flavor_depth": "Light & Refreshing (75% Crisp)",
  "message": "산뜻하게 정리된 MatchaLogic의 시스템 업데이트 로그입니다. 🍃",
  "statistics": {
    "totalUpdates": 43,
    "latestUpdate": {
      "version": "2.7.0",
      "date": "2026-07-25",
      "title": "실시간 다도 API 및 대화형 워크벤치 통합",
      "type": "feature"
    }
  }
}
GET/api/brew/hojicha.json

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

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

우려낸 결과

CodeDescription
200

Hojicha tech stack successfully retrieved.

Example Value (application/json)
                            {
  "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"
  }
}
GET/api/brew/coffee.json

커피 추출 요청 API (에러 반환 시뮬레이터)

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

우려낸 결과

CodeDescription
418

I'm a teapot (HTTP/1.1 418 I'm a teapot)

Example Value (application/json)
                            {
  "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"
}