Bypass Bookings
If your integration books reservations on behalf of your users and does not bill those users for those reservations within Mariana Tek, you're in the right place. To get started building, you'll first need to request an API Key and a sandbox by contacting integrations@marianatek.com. Once you have credentials, you can use the Admin API to list classes and create reservations for your users.
List Classes
For users to be able to book into classes, you'll most likely want to show them a list of the classes that are available to book for a brand, and give them the ability to filter this list. In Mariana Tek, an individual occurrence of a class that can be booked is called a class session. To display a schedule, you should use the Admin API to retrieve a list of class sessions and apply filters as query parameters.
Example Request:
Available Filters:
Parameter | Description |
---|---|
min_date | Excludes classes that are scheduled before this date. |
max_date | Excludes classes that are scheduled after this date. |
classroom | A comma-separated list of classroom IDs. |
location | A comma-separated list of location IDs. |
class_session_type | A comma=separated list of class_session_type IDs. |
employee_public_profiles | A comma-separated list of instructor profile IDs. |
class_tags | A comma-separated list of class tag IDs. |
Book a Reservation
Each of the reservations that your integration creates will be considered guest reservations within Mariana Tek. We consider a guest reservation any reservation that is paid for by a different user than the participant. For Bypass Booking, the user in your system who will be participating in the class will be considered a guest of the service user configured for your integration.
Example Request:
Parameter | Required? | Description |
---|---|---|
subdomain | yes | The subdomain corresponding to the brand where you would like to book. |
api_key | yes | The api_key credential issued for your integration. |
guest_email | yes | The email of the user participating in the class. If there is an account associated with this reservation, the account will be linked automatically. |
guest_name | no | The full name of the user participating in the class. |
reservation_type | no | Values are standard , standby or waitlist . This should be determined by the availability of the class. |
reserved_for_guest | yes | For bypass bookings, this should always be true . |
class_session_id | yes | The ID of the class that the user would like to book. |
service_user_id | yes | The ID of the service user associated with your application. |
Cancel a Reservation
Once a reservation has been booked, users may realize they cannot attend. If this is the case, users should be allowed to cancel their reservations.
Example Request: