Swagger/OpenAPI
Swagger/OpenAPI
micromicrofat
Python | Go | Deep Learning
展开
-
由于OAS中请求的MIME定义错误导致的connexion报错
今天在使用connexion开发接口过程中,不断报错:Traceback (most recent call last): File "/usr/local/lib/python3.8/dist-packages/flask/app.py", line 2447, in wsgi_app response = self.full_dispatch_request() File "/usr/local/lib/python3.8/dist-packages/flask/app.py", li原创 2021-08-17 17:32:19 · 398 阅读 · 0 评论 -
解决swagger生成的flask代码中的AttributeError: module ‘typing‘ has no attribute ‘GenericMeta‘错误
swagger生成的flask代码存在一个bug位置在swagger_server目录下的util.py文件中解决办法就是把下面的代码 elif type(klass) == typing.GenericMeta: if klass.__extra__ == list: return _deserialize_list(data, klass.__args__[0]) if klass.__extra__ == dict:原创 2021-03-20 15:11:29 · 1955 阅读 · 0 评论 -
Docker容器化部署Swagger Validator小工具
在使用swagger ui过程中不知道你们有没有注意到文档结尾右下角的小徽章点开后发现返回一串json{"schemaValidationMessages":[{"level":"error","message":"Can't read from file http://10.8.15.49:18081/wxapp_lottery_api.yaml"}]}这是Swagger提供的一个小工具,用来校验生成的文档说明文件是否符合语法规定的,如果符合就显示绿色的VALID徽章,否则就是黄色的原创 2021-02-23 15:32:40 · 392 阅读 · 0 评论 -
通过添加Access-Control-Allow-Origin首部字段,解决flask跨域问题
今天在使用swagger测试接口的时候出现无法获取返回的问题:TypeError: Origin http://10.8.15.49:18081 is not allowed by Access-Control-Allow-Origin.查看日志发现服务端确实收到请求而且正确返回了,用postman也能正常接收返回消息,但swagger ui却不行解决方法就是:...res = jsonify(res)res.headers.add('Access-Control-Allow-Origin'原创 2021-02-23 09:50:51 · 558 阅读 · 0 评论 -
OpenAPI Specification 3.0学习(不定时更新)
2021-02-21Path parameter "customercode" must have the corresponding {customercode} segment in the "/<customercode>/<fincorgid>/<prodlineid>" path将paths下的paths: /<customercode>/<fincorgid>/<prodlineid>:改为paths:原创 2021-02-21 13:54:32 · 423 阅读 · 0 评论 -
使用Swagger Codegen生成Python服务端客户端代码
生成服务端客户端代码的方式有很多种:通过Swagger Editor生成通过Swagger generator API生成通过Swagger Codegen CLI生成支持的语言和框架非常丰富:服务端:客户端:这里以Pyhton语言和Flask框架为例服务端下载好代码后解压缩.├── controllers│ ├── __init__.py│ ├── pet_controller.py│ ├── store_controller.py│ └── user原创 2020-09-28 10:50:41 · 2613 阅读 · 0 评论 -
Docker容器化部署Swagger三件套:Editor、Codegen、UI
说到Swagger就不得不说OpenAPI Specification(OAS),这两个之间存在千丝万缕的联系,不过也不必在意这些细节(主要是我也搞不清),就需要明白OAS是一个规范;Swagger是遵从这个规范的一个工具集之一;OAS目前版本为3.0.3;OAS规范是用来将RESTFul风格的API更容易被计算机和人类理解的,从这个意义上来说和高级编程语言很像;常用的Swagger工具包括:Swagger Editor开源本地、云端编辑API文档Swag原创 2020-09-19 16:41:42 · 2165 阅读 · 0 评论