zoukankan      html  css  js  c++  java
  • web API help pages with Swagger / OpenAPI

    https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger?view=aspnetcore-2.2

    When consuming a Web API, understanding its various methods can be challenging for a developer. Swagger, also known as OpenAPI, solves the problem of generating useful documentation and help pages for Web APIs. It provides benefits such as interactive documentation, client SDK generation, and API discoverability.

    In this article, the Swashbuckle.AspNetCore and NSwag .NET Swagger implementations are showcased:

    • Swashbuckle.AspNetCore is an open source project for generating Swagger documents for ASP.NET Core Web APIs.

    • NSwag is another open source project for generating Swagger documents and integrating Swagger UI or ReDoc into ASP.NET Core web APIs. Additionally, NSwag offers approaches to generate C# and TypeScript client code for your API.

    What is Swagger / OpenAPI?

    Swagger is a language-agnostic specification for describing REST APIs.

    The Swagger project was donated to the OpenAPI Initiative, where it's now referred to as OpenAPI.

    Both names are used interchangeably; however, OpenAPI is preferred.

    It allows both computers and humans to understand the capabilities of a service without any direct access to the implementation (source code, network access, documentation).

    One goal is to minimize the amount of work needed to connect disassociated services.

    Another goal is to reduce the amount of time needed to accurately document a service.

    Swagger specification (swagger.json)

    The core to the Swagger flow is the Swagger specification—by default, a document named swagger.json.

    It's generated by the Swagger tool chain (or third-party implementations of it) based on your service.

    It describes the capabilities of your API and how to access it with HTTP.

    It drives the Swagger UI and is used by the tool chain to enable discovery and client code generation.

    Here's an example of a Swagger specification, reduced for brevity:

     

     

    Swagger UI

    Swagger UI offers a web-based UI that provides information about the service, using the generated Swagger specification.

    Both Swashbuckle and NSwag include an embedded version of Swagger UI, so that it can be hosted in your ASP.NET Core app using a middleware registration call.

    The web UI looks like this:

     

    Each public action method in your controllers can be tested from the UI.

    Click a method name to expand the section.

    Add any necessary parameters, and click Try it out!.

     

    The Swagger UI version used for the screenshots is version 2. For a version 3 example, see Petstore example.

     

     

     

     

     

  • 相关阅读:
    git基本
    openwrt 固件的uci系统
    openwrt刷固件恢复原厂固件
    openwrt 登录管理页面openwrt管理页面密码
    openwrt固件升级方法
    OpenWrt简要介绍openwrt开发
    X86 openWRT 虚拟机编译教程 在ubuntu10中X86 OpenWRT的源码编译
    无线热点认证解决方案 WifiDog
    怎么把wifidog直接编译进openwrt
    portal为什么选择开源路由器第三方固件 OpenWrt
  • 原文地址:https://www.cnblogs.com/chucklu/p/10313359.html
Copyright © 2011-2022 走看看