maas-alliance / apis

Example APIs designed to support the MaaS ecosystem.

Apache License 2.0

4 stars 4 forks source link

Share (data) definitions between the APIs #11

Open brylie opened 6 years ago

brylie commented 6 years ago

We have a broad goal of creating multiple APIs, rather than a monolithic API specification. To that end, we should try to share data elements across API definitions, so our work is internally consistent (also externally harmonized).

Task

split data definitions into own file
add $ref tags in API definitions to link the data elements

brylie commented 5 years ago

Can reuse ModeInfo and particularly the "mode identifiers" to have a defined hierarchy of supported modes and make it consistent across APIs.

@nighthawk

The above review comment was made regarding the Booking API mode field.