샷 기록
어떤 버튼으로, 얼마를 목표로, 실제로 몇 g 나왔는지. 1초에 10번 기록한 곡선 5가지와 별점·메모까지 함께 와요.
GET /v1/public/shotsGET /v1/public/shots/{id}
무엇을 볼 수 있나요
머신이 이미 만들고 있는 데이터를 그대로 드려요
센서를 새로 달지 않아요. 제어 보드와 허브가 지금도 기록하는 값을 JSON 으로 보내 드려요. 미리보기에서는 아래 6가지를 열 계획이에요.
실시간 상태
보일러 온도 4곳, 압력, 유량, 히터 출력, 포터필터 장착 여부를 1초마다 받아볼 수 있어요.
GET /v1/public/machines/{serial}/telemetry/stream
머신 · 펌웨어 상태
모델, 그룹 수, 펌웨어 버전, 마지막 접속 시각, 업데이트 진행 상황. 머신이 직접 보고한 값만 저장해요.
GET /v1/public/machinesGET /v1/public/machines/{serial}
저울 연결
블루투스 저울 5개 브랜드의 무게·유량과 자동 정지 이유가 샷 기록에 같이 들어가요.
shot.scale.brand·auto_stop.reason
원격 설정 (허용된 것만)
조명, 밝기, 자동 꺼짐, 무드등, 절전 방식 7가지. 바꾼 값은 보드가 다시 읽어 확인한 뒤 알려 드려요.
PATCH /v1/public/machines/{serial}/settings
웹훅 알림
샷이 끝났을 때, 업데이트가 끝났을 때, 온도 경고가 떴을 때. 서명한 요청으로 내 서버에 보내 드려요.
shot.completed·ota.applied·alert.raised
어떻게 동작하나요
머신 → 허브 → 클라우드 → 내 앱
제어 보드가 허브(라즈베리 파이)로 값을 보내고, 허브가 클라우드에 보고해요. 개발자는 클라우드만 보면 돼요. 안전 한계는 보드 안에서만 지켜지고, 밖에서는 바꿀 수 없어요.
실제 샷 한 잔
이 곡선, 진짜예요
테스트 머신이 기록한 실제 버튼 샷이에요. API 응답의 숫자 배열이 그대로 이 선이 돼요. 저울을 연결한 샷이라 무게 곡선도 있어요.
최고 압력—
최고 유량—
최종 무게—
물 온도—
추출 시간—
비율 (원두 20.0 g)—
곡선 데이터를 불러오지 못했어요. file:// 로 열면 막히니 로컬 서버로 열어 주세요.
코드 한 줄
curl 한 줄이면 샷이 와요
API 키로는 읽기만 할 수 있어요. 설정을 바꾸려면 OAuth2 인증과 계약 범위가 따로 필요해요.
Request
# 프리뷰 초안 — 호스트·키는 예시
curl https://api.vidas.example/v1/public/shots/sh_01JB7Q \
-H "Authorization: Bearer vdas_pk_live_…" \
-H "Accept: application/json"Response · 200
{
"id": "sh_01JB7Q",
"machine": "VDAS-PRO1G-2644-9999",
"started_at": "2026-10-08T13:12:15Z",
"trigger": { "source": "button2", "mode": "scale" },
"dose_g": 20.0, "yield_g": 37.5, "duration_s": 14.0,
"peak": { "pressure_bar": 5.57, "flow_ml_s": 5.0 },
"series": {
"t_s": [0.0, 0.1, 0.2, …],
"pressure_bar": [2.59, 1.44, 0.92, …],
"flow_ml_s": [0.0, 0.0, 0.0, …],
"weight_g": [0.0, 0.0, 0.0, …],
"temp_mix_c": [91.1, 91.1, 91.1, …]
},
"scale": { "brand": "timemore", "auto_stop": { "reason": "target_weight" } }
}
라이브 쇼 · 전시용 앱 웹 버전
같은 데이터로, 전시장 TV 는 이렇게 그려요
Vidastech Dashboard 2.0 쇼 모드가 쓰는 시각화 3가지예요. 가짜 데이터 대신 위의 실제 샷을 다시 재생해요. 화면에 보일 때만 돌고, 벗어나면 멈춰요.
원격 제어, 어디까지
열리는 것과, 절대 열리지 않는 것
원격으로 바꿀 수 있는 설정은 허용 목록에 있는 것뿐이에요. 목록에 없는 건 경로 자체가 없어서 403 으로 끝나요. 안전 한계, 보일러 온도, 추출 설정, 펌웨어 설정은 앞으로도 열지 않아요.
허용 목록 — 원격으로 바꿀 수 있어요 open
shot_light_mode샷 조명display_brightness화면 밝기display_auto_off_s화면 자동 꺼짐ambient_enabled·ambient_brightness·ambient_rgb무드등heater_standby_type절전 방식
응답에 담긴 값은 보드가 다시 읽은 값이에요. 범위를 벗어나면 400, 목록에 없으면 403 이에요.
경로 없음 — 앞으로도 열지 않아요 no path
- 안전 한계 (과열 차단 · 최대 압력 · 연속 출수 시간)
- 보일러 목표 온도
- 추출 설정 (목표량 · 프리인퓨전 · 패들 프로파일)
- 펌웨어 설정 · 업데이트 실행
원격으로 추출을 시작하거나 멈추는 기능은 검토 중이에요. 계약과 안전 심사가 끝나야 결정해요.
요금제 (안)
읽기는 가볍게, 제어는 계약으로
가격은 계약할 때 정해요. 아래는 권한 구조 초안이에요.
Free
0원 · 개발 · 개인
- 60 req/min 읽기
- 30일 샷 기록 보관
- 머신 1대 · 실시간 연결 1개
- 원격 설정 변경 없음
Pro
계약가 · 매장 · 앱 개발사
- 600 req/min 읽기
- 전체 샷 기록 · 내보내기
- 10 웹훅 주소 · 실시간 연결 5개
- 허용된 설정 원격 변경 (OAuth2)
Enterprise
문의 · 여러 매장 · 프랜차이즈
- 머신 여러 대 · 조직 단위 키
- SLA · 전담 지원
- 데이터 한 번에 내보내기 (Parquet)
- 맞춤 요청 한도 · 감사 기록
로드맵 (안)
문서 먼저, 읽기 먼저, 제어는 맨 나중에
- 2026 Q4
미리보기 문서 공개 now
이 페이지와 개발자 문서 초안이에요. 신청자 피드백으로 스키마를 다듬어요.
- 2027 Q1
읽기 API 알파
머신·샷 조회, API 키 발급. 초대받은 개발자만 쓸 수 있어요.
- 2027 Q2
실시간 스트림 · 웹훅 베타
라이브 스트림과 서명 웹훅. Pro 요금제 시범 계약을 시작해요.
- 2027 Q3
허용된 설정 원격 변경
OAuth2 인증. 7가지 설정부터 열고, 안전 심사 뒤에 넓혀 가요.
- TBD
정식 출시 · 원격 추출 검토
원격 추출 시작·정지는 별도 안전 심사와 계약 조건이 먼저예요.
FAQ
자주 묻는 질문
지금 바로 쓸 수 있나요?
아직이에요. 지금은 문서 미리보기 단계예요. 미리 신청하면 알파 초대와 변경 소식을 먼저 받아요.
내 머신 데이터는 누가 볼 수 있나요?
머신 소유자(계약 당사자)가 발급한 키로만 볼 수 있어요. 키는 머신 1대 또는 조직 단위로만 동작해요.
온도나 압력을 원격으로 바꿀 수 있나요?
없어요. 안전 한계, 보일러 온도, 추출 설정은 원격으로 바꾸는 경로가 없고 앞으로도 열지 않아요. 조명·절전 같은 허용된 설정만 바꿀 수 있어요.
인터넷이 끊기면 샷 데이터가 사라지나요?
아니요. 허브가 먼저 저장해 두고, 연결이 돌아오면 올려요. 서버는 머신이 보고한 값만 저장해요.
얼마나 자주, 얼마나 길게 기록하나요?
1초에 10번이에요. 60초 샷이면 곡선 하나에 약 600개 점이 생기고, 곡선 5개가 한 기록에 들어가요.
SDK 도 나오나요?
TypeScript 와 Python 을 먼저 준비하고, Dart 는 검토 중이에요. 베타 전까지는 OpenAPI 문서와 curl 예시로 충분하게 만들 거예요.
미리 신청
먼저 써 보고 싶다면
알파 초대, 변경 소식, 계약 안내를 보내 드려요. 무엇을 만들고 싶은지 적어 주시면 먼저 챙겨 드릴게요.
이 페이지에서는 「신청하기」를 누르면 메일 앱이 열려요. 메일 앱이 없다면 아래 주소로 같은 내용을 보내 주세요.
preview@vidastech.example