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.