Main docs page Auth API Ordering API Menu API Venue API Inventory API Payment API Loyalty API Wallet API

Venue API (1.0)

Download OpenAPI specification:Download

OrderingStack venue API

Authentication

oauth2

Security Scheme Type OAuth2
password OAuth Flow
Token URL: https://ordering.3e.pl/auth-oauth2/{tenant}/oauth/token
Scopes:

    list

    Get paginated list of venues. This endpoint is compatible with React AdminOnRest framework to provide DataSource.

    query Parameters
    required
    object (VenuesFilter)
    header Parameters
    x-tenant
    string <uuid>

    Responses

    postVenue

    Update venue by ID. Works as upsert

    header Parameters
    x-tenant
    string <uuid>
    Request Body schema: */*
    id
    string[a-zA-Z0-9_.-]+
    name
    required
    string [ 1 .. 255 ] characters
    menu
    string[\p{L}\p{N}_.-]+
    active
    boolean
    tempDisabled
    boolean
    tempDisabledReason
    string [ 0 .. 255 ] characters
    object (Address)
    phone
    string [ 1 .. 64 ] characters
    email
    string
    description
    string [ 0 .. 1024 ] characters
    timeZone
    required
    string
    object (GeoPosition)
    object

    Map key refers to possible order types, like 'DELIVERY', 'TAKE_AWAY', 'DINE_IN', etc.

    Array of objects (CalendarException) [ 0 .. 7 ] items
    warehouse
    string[a-zA-Z0-9_.-]+
    sync
    boolean
    syncId
    string^[a-z0-9A-Z]+$
    object
    object

    Responses

    getVenue

    Get venue by ID

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    header Parameters
    x-tenant
    string <uuid>

    Responses

    putVenue

    Update venue by ID. Works as upsert

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    header Parameters
    x-tenant
    string <uuid>
    Request Body schema: */*
    id
    string[a-zA-Z0-9_.-]+
    name
    required
    string [ 1 .. 255 ] characters
    menu
    string[\p{L}\p{N}_.-]+
    active
    boolean
    tempDisabled
    boolean
    tempDisabledReason
    string [ 0 .. 255 ] characters
    object (Address)
    phone
    string [ 1 .. 64 ] characters
    email
    string
    description
    string [ 0 .. 1024 ] characters
    timeZone
    required
    string
    object (GeoPosition)
    object

    Map key refers to possible order types, like 'DELIVERY', 'TAKE_AWAY', 'DINE_IN', etc.

    Array of objects (CalendarException) [ 0 .. 7 ] items
    warehouse
    string[a-zA-Z0-9_.-]+
    sync
    boolean
    syncId
    string^[a-z0-9A-Z]+$
    object
    object

    Responses

    deleteVenue

    Delete venue by ID. Be careful as this is irreversible operation.

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    header Parameters
    x-tenant
    string <uuid>

    Responses

    activateVenue

    Activate venue by ID. Active venues can receive orders.

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    header Parameters
    x-tenant
    string <uuid>

    Responses

    deactivateVenue

    Deactivate venue by ID. Inactive venues cannot receive orders.

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    header Parameters
    x-tenant
    string <uuid>

    Responses

    validateCluster

    Validate venue cluster (batch of venues). Returns information if order can be made to those venues simultaneously. Currently only single venue is allowed.

    header Parameters
    x-tenant
    string <uuid>
    Request Body schema: */*
    venues
    required
    Array of strings [ 0 .. 16 ] items
    channel
    string [ 0 .. 32 ] characters [A-Z0-9_]+

    There is also 'orderType' alias of this field for backward compatibility.

    due
    string <date-time>
    object (GeoPosition)

    Responses

    getVenue_1

    Get venue by ID

    path Parameters
    venue
    required
    string[a-zA-Z0-9_.-]+
    query Parameters
    at
    string <date-time>

    Timestamp for exception calculation. Defaults to 'now'

    header Parameters
    x-tenant
    string <uuid>

    Responses

    getNearest

    Locate venues near provided geo position.

    query Parameters
    lat
    required
    number
    lng
    required
    number
    maxDistance
    number >= 0
    limit
    integer <int32> [ 1 .. 100 ]
    at
    string <date-time>

    Timestamp for exception calculation. Defaults to 'now'

    header Parameters
    x-tenant
    string <uuid>

    Responses