BoB major release profiles
Official support
Samtrafiken is committed to support at least the API versions included in the latest major profile version and the previous major profile version. More information on API Official Support.
Description
- The below table describes the compatibility between the different versions of all specifications gathered in a "Profile" column.
- A new profile is created for each release of one or several major changes to one or several specifications (API, MTS, Schema).
- Each profile is denominated by current year (4-digits) followed by hyphen and next serial number for the current year. When year is changed the serial number restarts from 1.
- Each profile has a defined "Release date" representing the release date for when the major version(s) is officially released.
- The versions of the specifications are described only with each Major version.
- Reference: Change Management Process and semver.org
- Each change for each specification in each profile is highlighted with a color in the related cell of the table.
- References to Jira and "Release notes" for each profile presented in table in "Release Notes" section.
Release Notes
Each Major Profile has its own Release Notes page linked to in the profile tag in below table.
Major profile name | 2017-1 | 2019-1 | 2020-1 |
---|---|---|---|
Release Date | - | 2019-07-01 | 2020-12-09 |
API | API major version | API major version | API major version |
Participant Metadata | 1 | 2 | 2 |
Authentication | 1 | 1 | 1 |
Device | 1 | 2 | 2 |
Product | 1 | 2 | 3 |
Ticket | 1 | 2 | 3 |
Validation | 1 | 2 | 3 |
Inspection | 1 | 1 | 2 |
Booking | 1 | 1 | 2 |
Traveller | 1 | 3 (*) | 3 (*) |
Token | 1 | 1 | 1 |
MTS | Major version | Major version | Major version |
MTS 1 - Mobile Ticket Format | 1 | 1 | 1 |
MTS 2 - Device Key Derivation | 1 | 1 | 1 |
MTS 3 - Coordinated Ticket Name Space | 1 | 1 | 1 |
MTS 4 - Coordination and Key Management | 1 | 1 | 1 |
MTS 5 - Proof-of-possession Authorisation Tokens | 1 | 1 | 1 |
MTS 6 - TICKLE – A Language for Ticket Validation | 1 | 1 | 1 |
MTS 7 - Token - ID based travelling | 1 | 1 | 1 |
MTS 8 - Date and time formats | 1 | 1 | 1 |
Schema | Major version | Major version | Major version |
bob-authz-groups | 1 | 1 | 1 |
coordinated-namespace | 1 | 1 | 1 |
traveller-category-table | 1 | 1 | 1 |
generic-categories | - | 1 | 1 |
product-conditions | 1 | 1 |
Footnotes
* - It was decided on CAB 2021-11-23 that Traveller API 3.0.0 was to be introduced in both major profile 2019-1 and 2020-1 since no one had implemented the previous version