search

UnionInternationalCheminsdeFer / OSDM

Projects related to an open sales & distribution API for public transportation.
https://osdm.io
Apache License 2.0
57 stars 21 forks source link

API to obtain Version #379

Open jspetrak opened 11 months ago

jspetrak commented 11 months ago

Example from version which has an update and sunset scheduled:

GET /version

{
    "version": "3.1.0",
    "sunsetAt": "2024-07-01T00:00:00+01:00",
    "nextVersion" : {
        "version": "4.0.0",
        "availableAt": "https://osdm.bahn.de/4.0",
        "availableFrom": "2024-04-01T00:00:00+01:00"
    }
}

Example of response from the latest version or version not having sunset datetime set:

GET /version

{
    "version": "4.0.0",
}
jspetrak commented 11 months ago

Also consider providing multiple version from API Proxy when running behind single URL and accessible using HTTP header discriminator.

jspetrak commented 11 months ago

Decide the design after agreement on versioning.

jspetrak commented 2 months ago

Putting to 3.4.0 to have visibility. I expect that to drag that to further versions (4.0.0) if IANA doesn't approve OSDM MIME Type soon.