API Documentation - chanandrew96/MyLearning GitHub Wiki
| Type | Documentation | Reference |
|---|---|---|
| Specification | Swagger | Flask-RESTX |
| Swagger Client | ||
| Tool | Swagger UI | Tool based on Swagger |
| Tool | Redoc | Using OpenAPI Standard (fka Swagger) |
| Tool | DapperDox | Open-Source API documentation generator and server for OpenAPI Swagger specifications |
| Tool | 42Crunch | Create API Documentation based on OpenAPI with Swagger, also provided function for checking API Security |
| Specification | OpenAPI | Work with WebSphere Application Server Liberty (Java) |
| FaskAPI + OpenAPI |
Swagger
Work with Flask
| Library | Description |
|---|---|
| Flask-RESTful | Create RESTful API |
| Flask-RESTPlus | Added Swagger into Flask-RESTful to generate API Documentation |
| Flask-RESTX | New version based / forked from Flask-RESTPlus due to lack of maintenance of Flask-RESTPlus |
Use Swagger (Flask-RESTX) with API Core
doc - Swagger route root
# Browse to http://127.0.0.1:[HOST PORT]/api/doc for Swagger doc
api = Api(app, version='0.0.1', title='Flask-RESTX and Swagger test', doc='/api/doc')
# Disable Swagger in Flask-RESTX
api = Api(app, version='0.0.1', title='Flask-RESTX and Swagger test', doc=false)
Documenting with the @api.doc() decorator
Flask-RESTX Documentation Reference
@api.route('/my-resource/<id>', endpoint='my-resource')
@api.doc(params={'id': 'An ID'})
class MyResource(Resource):
def get(self, id):
return {}
@api.doc(responses={403: 'Not Authorized'})
def post(self, id):
api.abort(403)
OpenAPI
Generate TypeScript using OpenAPI Documentation
References
difference between Flask-RESTful and Flask-RESTx
Flask RestPlus VS flask-restx
月光下的Flask之旅系列 第 28 篇 - Day 28 Flask-RESTX
Flask 学习-46.Flask-RESTX 生成 Swagger 文档入门教程
Documenting with the decorator
Flask API Documentation using Flask-Restx (Swagger for Flask)
Setting Up Swagger 2 with a Spring REST API Using Springfox