swagger.json生产客户端两种方式

1.Swagger简介

Swagger 是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。

 作用:

    1. 接口的文档在线自动生成。

    2. 功能测试

 

2.swagger生产客户端两种方式

2.1在线编辑

https://editor.swagger.io/#/

2.2代码生成

 

java -jar swagger-codegen-cli.jar generate -i E:\mywork\xxx.json -l java -o E:\test\xxx-java-gen --api-package com.xxx.client  --invoker-package com.xxx.client.invoker --model-package com.xxx.client.model

 

3.权限认证

3.1.权限认证 添加header参数

    "host": "api-b.essentialhub.com",

"securityDefinitions": {

"APIKey": {

  "type": "apiKey",

  "name": "Authorization",

  "in": "header"

}

    },

    "security": [

{

  "APIKey": []

}

],

 


版权声明:本文为qq_21153641原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。