Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General virtual queue documentation is available under Virtual Queues section: Virtual Queues The documentation describes queue setup, management and different features.

Info

Some of endpoints require organization level ApiKey that has to be generated by Ombori team at a request.

This document contains overview of exposed APIs that were used for integration by partners:

...

Queue tickets

Bookings

...

Get time slots for a queue - Get time slots

  • Can be used to present available time slots for particular queue

...

Create booking - Create booking

  • Can be used to create new booking in a queue

Create time slot reservation - Create time slot reservation

...

Request authentication

Some endpoints require an organization-level API key, which must be generated by the Ombori team upon request.

API URL

The {base-url} of the Grid Queues API depends on the data residency you’re working with. Make sure you use the correct URL for the data residency assigned to your tenant.

{tenantId} is your tenant identifier, which can be found in Grid Console.

Region

URL

EU

https://api.omborigrid.com/regions/eu/queues/v1/organizations/{tenantId}

US

https://api.omborigrid.com/regions/us/queues/v1/organizations/{tenantId}

IN

https://api.omborigrid.com/regions/in/queues/v1/organizations/{tenantId}

AU

https://api.omborigrid.com/regions/au/queues/v1/organizations/{tenantId}

UAE

https://api.omborigrid.com/regions/uae/queues/v1/organizations/{tenantId}

API overview

Queue Tickets

  • Ticket Creation (join the queue)

    • Allows the creation of a ticket with attached customer information and the addition of the ticket to the virtual queue.

  • Get Ticket

    • Retrieves information about a ticket, including its current status, which can be presented in a custom UI.

  • Subscribe to Ticket Changes through WebSocket/SignalR

    • Enables real-time UI updates, such as when a ticket is called forward.

Bookings

  • Get Time Slots for a Queue

    • Returns available time slots for a particular queue.

  • Create Booking

    • Allows the creation of a new booking in a queue.

  • Create Time Slot Reservation

    • Creates a time slot reservation, which is an unconfirmed booking.

    • Useful for flows where reservation requires confirmation, for example, by

      doing

      making a payment.

  • Update

    time slot reservation - Update time slot reservation
    • Can be used to update reservation information (can’t confirm reservation)

    Confirm time slot reservation - Confirm time slot reservation

    Can be used to transform

    Time Slot Reservation

    • Updates reservation information.

  • Confirm Time Slot Reservation

    • Transforms a time slot reservation into a valid (confirmed) booking, for example, when payment is confirmed.

Common

  • Cancel

    ticket

    Ticket, Booking,

    booking or reservation - Cancel ticket or reservation Can be used for cancelling

    or Reservation

    • Cancels any kind of ticket.

  • Update

    ticket

    Ticket, Booking,

    booking or reservation - Update position or reservation Can be used for updating

    or Reservation

    • Updates any kind of ticket.

  • Webhooks -

    • The Ombori Grid Virtual Queues solution has a webhook mechanism to expose various events happening in the system to a third

    -
    • party.

    • Complete A complete list of available webhooks and payload description descriptions is available here: Webhooks integration .

    • Webhooks can be configured by the Ombori team on at the queue level.

  •  
  •  

Any other functionality can be exposed, and we are expanding the available API as we go, depending on requirements.