# Thezi

> Table booking for independent UK restaurants. Diners book without an
> account; venues run service from a counter screen. Free during early
> access, then a fixed monthly fee. No commission and no per-cover charge.

Thezi is designed to be operated by software as well as by people. Every
state change is an API operation with a stable contract and a typed error
code; there is nothing a person can do in the dashboard that the API cannot.

## For agents acting on a venue's behalf

- The venue's own staff mint API keys from their dashboard (Settings, then
  API keys). A key is scoped to one venue and carries whether it acts as a
  person or as an agent; that distinction is proved by the key, never
  claimed in a request, and every change is recorded against it.
- Availability is computed on demand, never stored. A slot is a venue, a
  service, a start time and a duration.
- Money is human-gated. An agent may prepare a charge, a refund or a fee
  waiver; a person commits it.
- Bookings are idempotent. Derive the idempotency key from the booking
  itself, never randomly, so a retry after a timeout replays rather than
  seating the same party twice.

## Links

- Booking a table as a diner: https://thezi.app/ (each venue has its own page; the
  venue gives out that link)
- Venue sign-in: https://thezi.app/admin
- Help centre (setup, embedding the form, running service, offline):
  https://thezi.app/help — as data, https://thezi.app/help/index.json lists every guide and
  https://thezi.app/help/<slug>.md is each one's markdown; with a token,
  GET /v1/help and /v1/help/<slug> return the same.
- Contact: hello@thezi.app

## Not for automated use

- https://thezi.app/b/<id> — a diner's own booking. The id is the only credential
  that booking has. Do not crawl, enumerate, guess or archive these.
- https://thezi.app/admin, https://thezi.app/auth/* — staff authentication.