openactive / open-booking-api

Repository for the Open Booking API specification
Other
2 stars 3 forks source link

Barcode content specification #130

Open nickevansuk opened 4 years ago

nickevansuk commented 4 years ago

Proposer

ODI

Use Case

To allow barcode generation by the Broker, the Open Booking API specification includes an "Extension point for barcode-based access control". This is intended to "help inform future versions of the specification".

Why is this needed?

Barcodes are incredibly complicated, and schema.org itself shied away from "trying to represent the many varied types of barcode system and content that they carry" ref.

This issue is intended to be the start of the discussion around representing the most common barcode types in the sector.

Proposal

As a starter-for-10 proposal for convergence, the following beta property and values are defined:

Example

"accessPass": [
  {
    "@type": "Barcode",
    "url": "https://barcode.example.com/$T0123456789&codetype=code39",
    "text": "$T0123456789",
    "beta:codeType": "Code39"
  }
]