仙履奇缘 0.2.0

功能

• 将WADL源代码迁移到Swagger文件

• 提供在网页浏览器中显示RST加上Swagger JSON文件的功能

开发

首先运行迁移脚本来将wadl内容迁移到初始状态

./migrate.sh

此脚本将检出当前版本的文档。

要运行Web服务器，请使用

./run_server.sh

一个基于Pecan的Web服务器将监听 http://127.0.0.1:8080

grunt

目录结构（未来）

当前文档输出布局

api-doc/ -- the root of the documentation
api-doc/index.json  -- the index file that lists all the files that are included in the API doc.
api-doc/<service>/<version>.rst
api-doc/<service>/<version>/<request_schema>.json
api-doc/<service>/<version>/<response_schema>_<status_code>.json
api-doc/<service>/<version>/examples/<request>_req.json
api-doc/<service>/<version>/examples/<response>_resp_<status_code>.json
conversion_files_valid/<service-version>.json -- valid Swagger files

其他Swagger UI

来自 https://github.com/swagger-api/swagger-spec/wiki/Sites-and-Services

• http://docs.apimatic.apiary.io/

• http://docs.api2cart.com/post/interactive-docs

• http://chat.banckle.com/api/v3.0/

• http://www.evercam.io/develop/docs

• https://api.elastic.io/docs/

• https://developer.concur.com/

• https://www.callfire.com/api-documentation/rest/version/1.1

• https://www.bitmex.com/api/explorer/

• https://bitdango.com/api

• https://api.groupdocs.com/v2.0/spec/

• http://developer.wordnik.com/docs.html

• https://api.sensr.net/doc/v3/index.html

其他API文档工具

• https://github.com/danielgtaylor/aglio

其他客户端

• https://github.com/Orange-OpenSource/angular-swagger-ui

• https://github.com/apigee-127/swagger-client-API

• https://github.com/signalfx/swagger-ajax-client/

• https://github.com/signalfx/swagger-angular-client

• https://github.com/signalfx/swagger-client-generator

其他有用工具

• http://jsonschema.net/