🔌API Reference
API 문서
RESTful API로 ESTHERA를 외부 서비스와 연동하세요
REST APIJSONOAuth 2.0WebhooksBusiness 플랜
빠른 시작
api-example.ts
// 예약 생성 예시
const response = await fetch('https://api.esthera.kr/v1/bookings', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
customerId: 'cust_abc123',
staffId: 'staff_xyz789',
serviceId: 'svc_skin_001',
date: '2026-04-20',
startTime: '14:00',
endTime: '15:30',
note: 'VIP 고객 - 민감성 피부 주의'
})
});
const booking = await response.json();
// { id: "bk_...", status: "confirmed", ... }엔드포인트
GET
/api/v1/bookings예약 목록 조회 (페이지네이션, 날짜 필터)POST
/api/v1/bookings새 예약 생성 (자동 충돌 검증)GET
/api/v1/bookings/:id예약 상세 조회PATCH
/api/v1/bookings/:id예약 수정 (시간, 서비스, 담당자)DELETE
/api/v1/bookings/:id예약 취소POST
/api/v1/bookings/:id/confirm예약 확정