2018-09-12 - Booking API 1.0

Initial draft of Booking API 1.0, moving to formal publication

Summary

We've just published an initial editors draft of the Open Booking API 1.0. The updated document can be found here:

https://www.openactive.io/open-booking-api/EditorsDraft/index.html

Changes include:

• Orders now contain arrays of orderedItems and acceptedOffers

• A richer set of error conditions

• Revised modelling on Order, Payment, Error and around where properties

  such as privacyPolicy, termsAndConditions and potentialAction sit

• Improved modelling and documentation relating to cancellation of events

• Introduction of webhook subscription for brokers to be notified of

  events cancelled by booking systems

• Moved to use validFrom/validThrough for Offer as it expresses the

  intent more clearly than availabilityStarts/availabilityEnds

• Improved modelling of free offers which brings it into line with

  Modelling Specification 2.0

• Finalised new Booking models for Error and Payment

We are publishing this draft so that we can collect comments and feedback from the community as early as possible.

Please review the latest document and file your feedback on github:

https://github.com/openactive/open-booking-api/issues

We'd like to get this published as a formal community group deliverable in the next 2-3 weeks.

Slides

Video