Plain HTML quickstart
Take bookings on any website without a build step, first with the booking widget in two lines, then with a booking form of your own that calls the public booking API with fetch.
Tutorial5 min read
This works on any website you can add HTML to, without npm or a build step. Part 1 shows Booking Orbit's own booking screens on your page in five minutes. Part 2 builds a booking form in your own design with the public booking API.
Tested with: Chromium, a page served with python3 -m http.server, against a local Booking Orbit.
Before you start
You need:
- A Booking Orbit location with at least one service and someone who takes it, such as
northwilds-oslo. Its short name is the last part of its booking page address. - A way to serve a page, such as
python3 -m http.server 8080in a folder. Opening the file straight from disk doesn't work for part 2, because the browser then sendsnullas the website's address, which can't be allowed.
Part 1: the widget
1Add the widget
<!-- index.html --><!doctype html><html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Book a boot fitting at Northwilds Oslo</title> <script src="https://app.bifrostorbit.com/booking/widget.js" async></script> </head> <body> <h1>Book a boot fitting</h1> <div data-booking-orbit="northwilds-oslo" data-service="boot-fitting"></div> <p>Or <button type="button" data-booking-orbit-open="northwilds-oslo">see every service</button>.</p> </body></html>The div shows the booking screens for boot fittings in the page. The button opens every service in a popup.
2Try it
Open http://localhost:8080/index.html and book. The widget needs no settings in Booking Orbit, works on any website, and also takes payments for services paid in advance. Embed the booking widget lists its options.
Part 2: your own form
3Allow your website
Under the location's Settings › Your website, add http://localhost:8080 to Other websites, and your real website's address before you go live. Reading services works from any website, but holding and booking only from allowed ones. See Allowed websites.
4Add the form
<!-- book.html --><!doctype html><html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <title>Book at Northwilds Oslo</title> </head> <body> <main> <h1>Book at Northwilds Oslo</h1> <p id="error" role="alert" hidden></p> <ul id="services"></ul> <section id="times" hidden><h2>Pick a time</h2></section> <form id="details" hidden> <h2 id="chosen"></h2> <p>We're holding this time for you for 10 minutes.</p> <label>Name <input name="name" required autocomplete="name" /></label> <label>Email <input name="email" type="email" required autocomplete="email" /></label> <button type="submit">Book</button> </form> </main> <script type="module"> const API = "https://app.bifrostorbit.com/booking/api/public/northwilds-oslo"; const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone; const timeOf = (iso) => new Intl.DateTimeFormat("en-GB", { timeZone, hour: "2-digit", minute: "2-digit" }).format(new Date(iso)); const dateOf = (iso, zone = timeZone) => new Intl.DateTimeFormat("en-GB", { timeZone: zone, weekday: "long", day: "numeric", month: "long" }).format(new Date(iso)); const $ = (id) => document.getElementById(id); let service = null; let hold = null; async function call(path, body) { const response = await fetch(API + path, body ? { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) } : {}); const answer = await response.json(); if (answer.error?.code === "payment_required") location.href = answer.error.bookingUrl; if (!response.ok) throw Object.assign(new Error(answer.error.message), { status: response.status }); return answer.data; } function show(message) { $("error").textContent = message; $("error").hidden = !message; } function button(label, onClick) { const element = document.createElement("button"); element.type = "button"; element.textContent = label; element.addEventListener("click", onClick); return element; } async function choose(next) { service = next; hold = null; $("details").hidden = true; const slots = await call(`/slots?service=${service.id}&days=7&timeZone=${encodeURIComponent(timeZone)}`); $("times").replaceChildren($("times").firstElementChild); for (const day of slots.days.filter((entry) => entry.slots.length)) { const group = document.createElement("div"); const heading = document.createElement("h3"); heading.textContent = dateOf(`${day.date}T12:00:00Z`, "UTC"); group.append(heading, ...day.slots.map((slot) => button(timeOf(slot.startsAt), () => pick(slot.startsAt)))); $("times").append(group); } $("times").hidden = false; } async function pick(startsAt) { show(""); try { hold = await call("/holds", { service: service.id, startsAt }); hold.startsAt = startsAt; $("chosen").textContent = `${service.name} at ${timeOf(startsAt)}`; $("times").hidden = true; $("details").hidden = false; } catch (error) { show(error.message); if (error.status === 409) await choose(service); } } $("details").addEventListener("submit", async (event) => { event.preventDefault(); const form = new FormData(event.currentTarget); try { const { appointment } = await call("/appointments", { service: service.id, startsAt: hold.startsAt, holdToken: hold.token, name: form.get("name"), email: form.get("email"), timeZone }); const main = document.querySelector("main"); main.innerHTML = "<h1>You're booked</h1><p></p><p></p><p><a>Change or cancel</a></p>"; main.querySelectorAll("p")[0].textContent = `${appointment.service.name} with ${appointment.staff ?? "our team"}, ${dateOf(appointment.startsAt)} at ${timeOf(appointment.startsAt)}.`; main.querySelectorAll("p")[1].textContent = `Your reference is ${appointment.reference}. We've sent the details to ${appointment.attendee.email}.`; main.querySelector("a").href = appointment.manageUrl; } catch (error) { show(error.message); if (error.status === 409) await choose(service); } }); const { services } = await call("/services"); $("services").append(...services.map((entry) => { const item = document.createElement("li"); item.append(button(`${entry.name}, ${entry.durationMinutes} minutes`, () => choose(entry))); return item; })); </script> </body></html>What happens:
- GET
/serviceslists the services as buttons. - GET
/slotsasks for seven days of free times in the visitor's time zone, already grouped by their days. - POST
/holdskeeps the chosen time for 10 minutes while the visitor types. A409means someone else took it a moment ago, so the free times load again. For a service paid online when it's booked, the answer is409with the codepayment_required, and the visitor goes to itsbookingUrlon the booking page to book and pay. - POST
/appointmentsbooks with the hold's token. Booking Orbit emails the confirmation and the reminders, andmanageUrlis the visitor's page to change or cancel.
Text from the API is set with textContent, never as HTML.
5Try it
Open http://localhost:8080/book.html, choose a service, pick a time and book. The booking appears under Calendar in Booking Orbit. Cancel it with the Change or cancel link when you're done.
If booking fails with "This website isn't allowed to book here", the address in your browser isn't among the allowed websites. http://localhost:8080 and http://127.0.0.1:8080 are different addresses.
Make it yours
- Ask what the location asks: GET
/says whether a phone number and notes arerequired,optionalorhidden, and GET/services/<service>returns the form's questions. See the public booking API. - Paid services: The API doesn't take payments, so the form sends visitors to the booking page for services paid online, as above. To keep them on your page, use the widget from part 1.
- Using npm? The Booking SDK wraps these calls with types and errors.
Was this page helpful?