maas-schemas

response Schema

http://maasglobal.com/tsp/booking-update/response.json

Response schema for updating state of a specific booking with a TSP ID from a TSP adapter

Abstract	Extensible	Status	Identifiable	Custom Properties	Additional Properties	Defined In
Can be instantiated	No	Develop	No	Forbidden	Forbidden	tsp/booking-update/response.json

Schema Hierarchy

• response http://maasglobal.com/tsp/booking-update/response.json
  • booking http://maasglobal.com/core/booking.json
  • state http://maasglobal.com/core/components/state.json
  • booking-option http://maasglobal.com/core/booking-option.json
  • booking-meta http://maasglobal.com/core/booking-meta.json

response Properties

Property	Type	Required	Nullable	Defined by
cost	cost	Optional	No	response (this schema)
leg	object	Optional	No	response (this schema)
meta	booking-meta	Optional	No	response (this schema)
state	enum	Required	No	response (this schema)
terms	terms	Optional	No	response (this schema)
token	object	Optional	No	response (this schema)
tspId	string	Required	No	response (this schema)
tspProduct	object	Optional	No	response (this schema)

cost

cost

• is optional
• type: cost
• defined in this schema

cost Type

• cost – http://maasglobal.com/core/components/cost.json

leg

A leg delta, containing any subset of the valid properties

leg

• is optional
• type: object
• defined in this schema

leg Type

object with following properties:

Property	Type	Required
departureDelay		Optional
endTime		Optional
from		Optional
mode		Optional
startTime		Optional
to		Optional

departureDelay

departureDelay

• is optional
• type: duration

departureDelay Type

• duration – http://maasglobal.com/core/components/units.json#/definitions/duration

endTime

endTime

• is optional
• type: time

endTime Type

• time – http://maasglobal.com/core/components/units.json#/definitions/time

from

from

• is optional
• type: place

from Type

• place – http://maasglobal.com/core/components/place.json

mode

mode

• is optional
• type: travel-mode

mode Type

• travel-mode – http://maasglobal.com/core/components/travel-mode.json

startTime

startTime

• is optional
• type: time

startTime Type

• time – http://maasglobal.com/core/components/units.json#/definitions/time

to

to

• is optional
• type: place

to Type

• place – http://maasglobal.com/core/components/place.json

meta

meta

• is optional
• type: booking-meta
• defined in this schema

meta Type

• booking-meta – http://maasglobal.com/core/booking-meta.json

state

The life-cycle state of a booking

state

• is required
• type: enum
• defined in this schema

The value of this property must be equal to one of the known values below.

state Known Values

Value	Description
START
PENDING
PAID
RESERVED
CONFIRMED
ARRIVED
ACTIVATED
ON_HOLD
CANCELLED
EXPIRED
REJECTED
FINISHED
UNKNOWN

terms

terms

• is optional
• type: terms
• defined in this schema

terms Type

• terms – http://maasglobal.com/core/components/terms.json

token

The validity token (such as booking ID, travel ticket etc.) that MaaS clients will display to validate the trip when starting the leg.

token

• is optional
• type: object
• defined in this schema

token Type

object with following properties:

Property	Type	Required
data	object	Optional
meta	object	Optional
validityDuration	object	Optional

data

Arbitrary ticket data for the client

data

• is optional
• type: object

data Type

object with following properties:

| Property | Type | Required | | ——– | —- | ——– |

meta

Arbitrary metadata the TSP may pass along the ticket to the client (e.g. a booking code, base64 encoded binary)

meta

• is optional
• type: object

meta Type

object with following properties:

| Property | Type | Required | | ——– | —- | ——– |

validityDuration

The rules that MaaS will interpret to schedule, re-validate or cancel the booking.

validityDuration

• is optional
• type: object

validityDuration Type

object with following properties:

Property	Type	Required
endTime		Optional
startTime		Optional

endTime

The finishing time the ticket is valid for

endTime

• is optional
• type: time

endTime Type

• time – http://maasglobal.com/core/components/units.json#/definitions/time

startTime

The starting time from which the ticket is valid

startTime

• is optional
• type: time

startTime Type

• time – http://maasglobal.com/core/components/units.json#/definitions/time

tspId

tspId

• is required
• type: string
• defined in this schema

tspId Type

string

• minimum length: 1 characters
• maximum length: 256 characters

tspProduct

Defines what kind of TSP product the booking option represents.

tspProduct

• is optional
• type: object
• defined in this schema

tspProduct Type

object with following properties:

Property	Type	Required
id	string	Required

id

Unique identifier for the product

id

• is required
• type: string

id Type

string

• minimum length: 1 characters
• maximum length: 255 characters

This site is open source. Improve this page.