create_booking

com.pinsvit/api · Verify this server

Books a time at a place: for the signed-in user, or, by staff of the place, for a customer. First confirm with the user the place, the time, the services and, when it matters, the stream (a table, a chair or a specialist). Take startsAt and streamIds from find_booking_times, and send either the durationMinutes it answered for or an endsAt; with services, book exactly one stream. The result's status is CONFIRMED when the time is held, or PENDING when the business must accept it first — tell the user which. Retries: make up an idempotencyKey and resend it if the call fails or times out, so a retry cannot book twice. On a CONFLICT saying a booking is already in progress, call list_my_bookings before retrying: the first attempt may have succeeded without answering. Limits: each customer is limited in open bookings and requests per place and per day, and in bookings per 10 minutes and per day; a refusal names the limit. Moving a booking: book the new time with previousBookingId, then cancel the old one. The old booking still counts against those limits, so if the new time is refused, ask the user before cancelling first. Walk-in or phone booking, by staff at their own place: (1) list_my_places gives the place's geoHash and placeId; (2) find_booking_times with forCustomer true; (3) create_booking with a start and stream from that answer plus who it is for: customerName, and customerContacts (a phone) or customerEmail. Any of those three makes the booking the customer's. It is CONFIRMED at once, skips the minimum notice and the customer limits, and is refused with BOOKING_NOT_ALLOWED unless the caller works at the place; staff are limited to 30 such bookings per 10 minutes and 300 per day. Without customer arguments the booking is the caller's own, even when the caller is staff.