GBFS v3 and API paths

[testower]

GBFS v3 feeds are now available at /gbfs/v3beta/...

Considering v3 is strictly speaking no longer in beta, there's the question what the path should now be, and should we change other paths.

The situation is complicated further because our api gateway also has versioning for proxies:

https://api.entur.io/mobility/v2/gbfs/v3beta/voistavanger/gbfs

where /mobility/v2 simply points to the lamassu instance.

Overview of current paths

GBFS v2

• /gbfs - system discovery
• /gbfs/{systemid}/{feed}(.json) - system feeds

GBFS v2 internal (deprecated 🙏 see also #263)

• /gbfs-internal - system discovery
• /gbfs-internal/{systemid}/{feed}(.json) - system feeds

GBFS v3

• /gbfs/v3beta/manifest.json - system discovery
• /gbfs/v3beta/{systemid}/{feed}(.json) - system feeds

GraphQL

• /graphql - GraphQL endpoint
• /graphiql - GraphiQL UI if enabled

Validation

• /validation/* - validation (report) endpoints

Health

• /health/* - health probe endpoints

Admin endpoints

• /admin/* (not going into details on this)

[testower]

Let's discuss at the next meeting @hbruch

[testower]

Deprecate /gbfs
Add /gbfs/v2/ and /gbfs/v3 paths