Seats.io

The seatsio Developer Hub

Welcome to the seatsio developer hub. You'll find comprehensive guides and documentation to help you start working with seatsio as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Type: string
Possible values: 'continue', 'start', 'manual', 'none'
Default: 'none'

Start a session to temporarily hold objects upon selection.

A session lasts for 15 minutes (or whatever you set on your settings page). When the ticket buyer clicks on a place within that period, it gets held. Other users won't be able to book the same place within that period. If the place is not booked (e.g. payment has never been received) before the end of the session, it's automatically released again.

A session is identified by a hold token. Consider this the session ID. When starting a session, we store the hold token in session storage, so it's still available after a page refresh.

  • 'continue': continue a previously started session by using the hold token in session storage, or start a new session if there's no hold token.
  • 'start': start a new session (and generate a new hold token).
  • 'manual': continue the session identified by holdToken. Use this when you generated a hold token through our backend API.
  • 'none': session is disabled. Objects don't get held on click.

This article gives a more in-depth overview of the holding seats functionality.

Updated 2 months ago

session


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.