search

OpendataCH / Transport

Swiss public transport API
http://transport.opendata.ch/
MIT License
241 stars 50 forks source link

Add Swagger specification #130

Closed fabian closed 8 years ago

fabian commented 8 years ago

Swagger is a simple yet powerful representation of your RESTful API.

zircote/swagger-php is used to generate the swagger.json from annotations. dev-master is used because the unreleased version has a great feature which parses PHPDocs too.

Most descriptions are derived from the current documentation. That documentation could actually now automatically be generated from the swagger.json.

Fixes https://github.com/OpendataCH/Transport/issues/121.

fabian commented 8 years ago

Can be tested with Swagger UI demo and the URL http://transport.opendata.ch/swagger.json.