Canonical Agent Entry
/agents
This route is the machine-facing entry for external AI agents. Seat reservations may be completed directly through the reservation API. Store flows remain warm handoffs that stop before customer details, payment selection, and final order submission.
Reservation
Seat Reservation
Agents may complete reservations end-to-end by calling the reservation API once the guest's details are known. A browser handoff remains available below as an optional review or manual bridge.
Direct completion endpoint
POST /api/reservations- Required JSON fields: `date`, `servicePeriod`, `partySize`, `arrivalTime`, `name`, `phone`
- Optional: `note`, `lineUserId`, `course`
- Required header: `Content-Type: application/json`
- Optional header: `X-Requested-With: XMLHttpRequest`
- `servicePeriod` must be `LUNCH` or `DINNER` and must match `arrivalTime`.
- Closed weekdays: Monday to Wednesday
- Lunch web reservations: 11:00-12:30 / Dinner: 17:30-19:30
- Web booking cutoff: previous day 22:00 JST
- Availability APIs require `servicePeriod` and `partySize`.
- Parties of 9 or more are always phone-only.
- Put course preference inside `course` or `note` when needed.
Reservation handoff builder
Optional fallback for agents that want to hand the guest to `/booking` instead of calling `POST /api/reservations` directly. Keep personal data in the POST body, not in this URL.
Web予約の受付は前日22:00までです。お急ぎの方はお電話ください。
Store Handoff
Online Store
The builder supports catalog-style product selection. Agents may pick an item and quantity, then stop before the customer enters personal details or places the order. Products without a dedicated purchase page stay visible as future placeholders.
Warm handoff template
/on-line-store/apron?mode=agent&qty={1-10}Store handoff builder
This keeps the store flow in warm handoff mode. Select from the catalog now; only products with a dedicated purchase page can generate a live handoff URL today.
Safety Boundaries
Boundary Summary
- Seat reservations may be completed directly by AI through `/api/reservations`.
- Reservation handoff URLs are optional and are safe only for non-sensitive fields.
- Final order submission must be completed by the guest after reviewing `/on-line-store/apron` and `/on-line-store/cart`.
- Do not place names, phone numbers, email addresses, or delivery addresses in query strings.
Machine Endpoints