openmobilityfoundation / mobility-data-specification

A data standard to enable right-of-way regulation and two-way communication between mobility companies and local governments.
https://www.openmobilityfoundation.org/about-mds/
Other
676 stars 232 forks source link

MDS 2.0 - Stops should have same response structure as vehicles or vice versa #864

Closed lastalfriday closed 1 year ago

lastalfriday commented 1 year ago

I'm refer to the links property here..

https://openmobilityfnd.stoplight.io/docs/mds-openapi/bd99c2440acf4-stops

image

https://openmobilityfnd.stoplight.io/docs/mds-openapi/817070d4bd451-vehicles

image

lastalfriday commented 1 year ago

...also I see a new property version in the response here. If you are going to use this, please use it in all responses across all endpoints

schnuerle commented 1 year ago

Version will be available in all responses.

I don't think all responses have pagination options. But not sure if they should.

thekaveman commented 1 year ago

also I see a new property version in the response here. If you are going to use this, please use it in all responses across all endpoints

version is returned in every GET payload across MDS, we added it to the few missing ones in this OpenAPI update. Except for the following endpoints:

Paging (the links object) is explicitly disallowed in some endpoints, such as /trips and /events/historical in Provider:

The /trips and /events/historical endpoints must not use pagination.

schnuerle commented 1 year ago

I think this was resolved in 2.0. @lastalfriday let us know if there is something here that needs more work for a future release.