공개 API(읽기 전용)
Public read-only API for AI agents and integrations
予約Lite 매장 페이지의 정보(메뉴·요금·예약 가능 시간대)를 조회할 수 있습니다. 인증은 필요하지 않습니다. 예약 확정은 API로 할 수 없습니다. 고객을 매장의 예약 페이지 https://yoyakulite.com/book/{slug} 로 안내해 주세요.
- OpenAPI 3.1: https://yoyakulite.com/openapi.json
- API catalog (RFC 9727): https://yoyakulite.com/.well-known/api-catalog
- 시각은 모두 ISO 8601(UTC)입니다. 매장의 시간대(예: Asia/Tokyo)를 함께 반환합니다. 요금은 세금 포함(엔)입니다.
GET /api/stores/{slug}
매장명·접수 상태·취소 기한과 예약 가능한 메뉴(소요 시간·세금 포함 요금·옵션)를 반환합니다.slug 는 예약 페이지 URL의 끝부분입니다.
curl https://yoyakulite.com/api/stores/demo-salonGET /api/availability/month?slug=&serviceId=&month=YYYY-MM
지정한 메뉴의 날짜별 예약 가능 시간대 수를 반환합니다. 옵션을 추가하는 경우에는 options=id1,id2(소요 시간이 늘어나 예약 가능 시간대가 달라집니다).
curl "https://yoyakulite.com/api/availability/month?slug=demo-salon&serviceId=<services[].id>&month=2026-10"GET /api/availability?slug=&serviceId=&date=YYYY-MM-DD
지정한 날짜의 예약 가능한 시작 시각(slots）을 반환합니다. 접수 중지 중에는 error: "paused" 가 붙습니다.
curl "https://yoyakulite.com/api/availability?slug=demo-salon&serviceId=<services[].id>&date=2026-10-01"GET /api/version
가동 중인 버전(헬스 체크).
curl https://yoyakulite.com/api/version오류
400 bad_request(파라미터 누락·형식 오류),400 unknown_option、404 not_found(매장 없음),404 service_not_found。본문은 {"error": "..."} 입니다.
이용에 대하여
매장 영업에 지장을 주는 대량 접속은 삼가 주시기 바랍니다. 예약 대행 및 자동 확정은 지원하지 않습니다. 문의는 특정상거래법에 따른 표기의 연락처로 해 주십시오.