Train Travel API

18 days ago

Change #517d2de1

1.3.0

Compare

Navigation Tags: Custom sections "Search", "Booking & Payment"
Badge tags: Define some tags to some operations without x-topic (Bump.sh specific)
Servers have a name
New operation SUBSCRIBE /trips/{id} (custom verb defined via additionalOperations).
Search operation GET /stations is now deprecated, and badged as 'Removed next release', replaced by QUERY /stations (new verb supported via OAS 3.2 with badge Beta)
Examples:
- favor Example Object syntax, and use new field dataValue instead of deprecated (and confusing) value
- Use new field serializedValue for SUBSCRIBE /trips/{id} examples.
SecuritySchemes:
- add oauth2MetadataUrl to existing oauth2
- add a new scheme deviceAuthorization

3 structure changes including:

2 Additions

1 Modification

Modified 1

GET /stations

Operation is now deprecated

Added 2

QUERY /stations

SUBSCRIBE /trips/{id}

27 days ago

Change #7e7b28bb

1.2.1

Breaking

Compare

3 structure changes including:

3 Modifications

Modified 3 Breaking

GET /bookings/{bookingId}

Response
200 response Modified
- application/json content type Modified
  - trip_id, passenger_name properties Modified
    - Properties are now required
      Breaking
- application/xml content type Modified
  - trip_id, passenger_name properties Modified
    - Properties are now required
      Breaking

POST /bookings

Body
application/json content type Modified
- trip_id, passenger_name properties Modified
  - Properties are now required
    Breaking
application/xml content type Modified
- trip_id, passenger_name properties Modified
  - Properties are now required
    Breaking
Response
201 response Modified
- application/json content type Modified
  - trip_id, passenger_name properties Modified
    - Properties are now required
      Breaking
- application/xml content type Modified
  - trip_id, passenger_name properties Modified
    - Properties are now required
      Breaking

POST newBookingwebhook

Body
application/json content type Modified
- trip_id, passenger_name properties Modified
  - Properties are now required
    Breaking

Dec 23, 2024

Change #bf98c8ce

1.2.0

Breaking

Compare

2 structure changes including:

2 Modifications

Modified 2 Breaking

GET /trips

Response
200 response Modified
- application/json content type Modified
  - data property Modified
    - self property Added

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- source property Modified
  - Card alternative Modified
    - cvc property Modified
      - Type went from integer to string
        Breaking

Dec 17, 2024

Change #516667da

1.0.0

Breaking

Compare

1 structure change including:

1 Modification

Modified 1 Breaking

POST newBookingwebhook

Body
application/json content type Modified
- Content type is now required
  Breaking

Nov 21, 2024

Change #f208c019

1.0.0

Compare

1 structure change including:

1 Modification

Modified 1

GET /stations

Response
200 response Modified
- application/json content type Modified
  - links property Added

Nov 5, 2024

Change #9ae4bd19

1.0.0

Breaking

Compare

3 structure changes including:

3 Modifications

Modified 3 Breaking

GET /bookings

Query
limit query parameter Added

GET /stations

Query
limit, country query parameters Added

GET /trips

Query
page query parameter Modified
- Type went from number to integer
  Breaking
limit query parameter Added

Oct 16, 2024

Change #570849d1

1.0.0

Compare

1 structure change including:

1 Modification

Modified 1

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- source property Modified
  - Combinator went from anyOf to oneOf
Response
200 response Modified
- application/json content type Modified
  - source property Modified
    - Combinator went from anyOf to oneOf

Oct 15, 2024

Change #1f53940c

1.0.0

Compare

1 structure change including:

1 Modification

Modified 1

GET /bookings

Query
page query parameter Added

Oct 9, 2024

Change #45539426

1.0.0

Compare

1 structure change including:

1 Modification

Modified 1

GET /trips

Query
page query parameter Added

Aug 29, 2024

Change #e71ee198

1.0.0

Breaking

Compare

1 structure change including:

1 Modification

Modified 1 Breaking

GET /stations

Query
country query parameter Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking
search query parameter Added

Aug 29, 2024

Change #29b6d1ba

1.0.0

Breaking

Compare

1 structure change including:

1 Modification

Modified 1 Breaking

GET /stations

Response
200 response Modified
- application/json content type Modified
  - links property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
Query
page, coordinates, country query parameters Added

May 29, 2024

Change #cc2690f0

1.0.0

Breaking

Compare

1 structure change including:

1 Modification

Modified 1 Breaking

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- Content type is now required
  Breaking

Mar 12, 2024

Change #264c25e2

1.0.0

Compare

1 structure change including:

1 Modification

Modified 1

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- source property Modified
  - Discriminator name is no longer object
Response
200 response Modified
- application/json content type Modified
  - source property Modified
    - Discriminator name is no longer object

Mar 6, 2024

Change #33dea978

1.0.0

Breaking

Compare

5 structure changes including:

2 Additions

3 Modifications

Modified 3 Breaking

POST /bookings

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added
application/xml content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added
Response
201 response Modified
- application/json content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Added
- application/xml content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Added

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- amount, currency, source properties Added
Response
200 response Modified
- application/json content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, amount, currency, source, status properties Added

POST newBookingwebhook

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added

Added 2

DELETE /bookings/{bookingId}

GET /bookings/{bookingId}

Mar 6, 2024

Change #9ef36690

1.0.0

Breaking

Compare

5 structure changes including:

2 Breaking changes

3 Modifications

2 Removals

Modified 3 Breaking

POST /bookings

Body
application/json content type Modified
- trip_id, passenger_name, has_bicycle, has_dog properties Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- data property Added
application/xml content type Modified
- trip_id, passenger_name, has_bicycle, has_dog properties Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- data property Added
Response
201 response Modified
- application/json content type Modified
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - data property Added
- application/xml content type Modified
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - data property Added

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- amount, currency, source properties Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- data property Added
Response
200 response Modified
- application/json content type Modified
  - id, amount, currency, source, status properties Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - data property Added

POST newBookingwebhook

Body
application/json content type Modified
- trip_id, passenger_name, has_bicycle, has_dog properties Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- data property Added

Removed 2 Breaking

DELETE /bookings/{bookingId}

Removing a resource is always breaking unless it was deprecated before
Breaking

GET /bookings/{bookingId}

Removing a resource is always breaking unless it was deprecated before
Breaking

Mar 6, 2024

Change #e492018f

1.0.0

Breaking

Compare

5 structure changes including:

2 Additions

3 Modifications

Modified 3 Breaking

POST /bookings

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added
application/xml content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added
Response
201 response Modified
- application/json content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Added
- application/xml content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, trip_id, passenger_name, has_bicycle, has_dog properties Added

POST /bookings/{bookingId}/payment

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- amount, currency, source properties Added
Response
200 response Modified
- application/json content type Modified
  - data property Removed
    - Removing a resource is always breaking unless it was deprecated before
      Breaking
  - id, amount, currency, source, status properties Added

POST newBookingwebhook

Body
application/json content type Modified
- data property Removed
  - Removing a resource is always breaking unless it was deprecated before
    Breaking
- trip_id, passenger_name, has_bicycle, has_dog properties Added

Added 2

DELETE /bookings/{bookingId}

GET /bookings/{bookingId}

Feb 21, 2024

Change #d39e0be8

1.0.0

Breaking

Compare

6 structure changes including:

2 Additions

4 Modifications

Modified 4

GET /bookings

Response
200 response Modified
- application/json content type Modified
  - data property Modified
- application/xml content type Modified
  - data property Modified
Authentication
OAuth2 authentication method Added

GET /stations

Authentication
OAuth2 authentication method Added

GET /trips

Response
400 response Added
Authentication
OAuth2 authentication method Added

POST newBookingwebhook

Response
200 response Added

Added 2

POST /bookings

POST /bookings/{bookingId}/payment

Feb 13, 2024

Change #f6f52869

1.0.0

Compare

1 structure change including:

1 Addition

Added 1

POST newBookingwebhook

Feb 13, 2024

Change #8d1dd6ad

1.0.0

Breaking

Compare

4 structure changes including:

1 Breaking change

3 Modifications

1 Removal

Modified 3 Breaking

GET /bookings

Authentication
OAuth2 authentication method Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking

GET /stations

Authentication
OAuth2 authentication method Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking

GET /trips

Authentication
OAuth2 authentication method Removed
- Removing a resource is always breaking unless it was deprecated before
  Breaking

Removed 1 Breaking

POST /bookings

Removing a resource is always breaking unless it was deprecated before
Breaking

Feb 13, 2024

Change #b96acf15

1.0.0

Compare

4 structure changes including:

4 Modifications

Modified 4

GET /bookings

Response
200 response Modified
- application/xml content type Added
400 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
401 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
403 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
429 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
500 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added

GET /stations

Response
200 response Modified
- application/xml content type Added
400 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
401 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
403 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
429 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
500 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added

GET /trips

Response
200 response Modified
- application/xml content type Added
401 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
403 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
429 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
500 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added

POST /bookings

Response
201 response Modified
- application/xml content type Added
400 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
401 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
404 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
409 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
429 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
500 response Modified
- application/problem+json content type Modified
  - Full types is now object
  - Problem.yaml property Added
- application/problem+xml content type Added
Body
application/xml content type Added

Do not miss any Train Travel API changes, ever again

Changelog

Upgrade to OpenAPI 3.2

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed

API structure has changed