POST

api

apps

marketplaceapplications

book

📆Book resource

curl --request POST \
  --url https://spaces.nexudus.com/api/apps/marketplaceapplications/book \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketplace_id": "<string>",
  "location_id": "<string>",
  "resource_id": "<string>",
  "start_local": {}
}
'

import requests

url = "https://spaces.nexudus.com/api/apps/marketplaceapplications/book"

payload = {
    "marketplace_id": "<string>",
    "location_id": "<string>",
    "resource_id": "<string>",
    "start_local": {}
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    marketplace_id: '<string>',
    location_id: '<string>',
    resource_id: '<string>',
    start_local: {}
  })
};

fetch('https://spaces.nexudus.com/api/apps/marketplaceapplications/book', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "price": {},
  "confirmation": {},
  "available": true,
  "message": "<string>",
  "error_code": "<string>"
}

📆Book resource

Creates a booking for a given resource, start date and duration.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.

Request Body

string

required

The unique id of your marketplace application

string

required

The unique id of a location

string

required

The unique id of the location to get the calendar for

string (date-time)

required

The earliest date to show bookings for. The date and time are parsed in the local time of the passed in location.

string

The unique id of a desk defined within a resource.

integer (int32)

The amount of minutes after the start_local time to show data for. Defaults to 60 minutes.

string

The full name of the customer making this booking. Required when “email” is provided.

string

The email of the customer making this booking. . Required when “fullname” is provided.

string

A note to add alongside the booking. Customers will be able to see this note.

string

A note to add alongside the booking. Only operators will be able to see this note.

array

Response

200

object

boolean

Example: false

string

Example: This resource is already booked. Please choose a different start and end times.

string

Example: BOOKING_CONFLICT

Example Response

{
  "price": {
    "amount": 4.81,
    "currency": "USD"
  },
  "confirmation": {
    "confirmed": false,
    "message": null,
    "booking_id": null
  },
  "available": false,
  "message": "This resource is already booked. Please choose a different start and end times.",
  "error_code": "BOOKING_CONFLICT"
}

Example Request

curl -X POST \
  "https://spaces.nexudus.com/api/apps/marketplaceapplications/book" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

📆Update resource bookingUpdates a booking for a given resource, start date and duration.

📆Book resource

curl --request POST \
  --url https://spaces.nexudus.com/api/apps/marketplaceapplications/book \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "marketplace_id": "<string>",
  "location_id": "<string>",
  "resource_id": "<string>",
  "start_local": {}
}
'

import requests

url = "https://spaces.nexudus.com/api/apps/marketplaceapplications/book"

payload = {
    "marketplace_id": "<string>",
    "location_id": "<string>",
    "resource_id": "<string>",
    "start_local": {}
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    marketplace_id: '<string>',
    location_id: '<string>',
    resource_id: '<string>',
    start_local: {}
  })
};

fetch('https://spaces.nexudus.com/api/apps/marketplaceapplications/book', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "price": {},
  "confirmation": {},
  "available": true,
  "message": "<string>",
  "error_code": "<string>"
}

Getting Started

Endpoints

Marketplace applications

📆Book resource

📆Book resource

Authentication

Request Body

Response

200

Example Request

​📆Book resource

​Authentication

​Request Body

​Response

​200

​Example Request

📆Book resource

Authentication

Request Body

Response

200

Example Request