swagger node

[xgqfrms]

swagger node

https://github.com/swagger-api/swagger-node

https://app.swaggerhub.com/apis/xgqfrms/test/1.0.0#/

[xgqfrms]

docs

https://github.com/swagger-api/swagger-node

https://swagger.io/docs/specification/about/

UI

https://swagger.io/download-swagger-ui/

https://swagger.io/docs/swagger-tools/#usage-34
https://swagger.io/docs/swagger-tools/#download-33

[xgqfrms]

translate

https://github.com/gildata/swagger-node

Tutorial

# install CLI
$ npm i -g swagger

# create a new swagger project
$ swagger project create hello-world

# editor API
$ swagger project edit hello-world


# run server
$ swagger project start hello-world


# call api
$ curl http://127.0.0.1:10010/hello?name=xgqfrms
# { "message": "Hello, xgqfrms!" }

controller

function hello(req, res) {
    var name = req.swagger.params.name.value || 'stranger';
    var hello = util.format('Hello, %s!', name);
    res.json({ "message": hello });
}

    paths:
        /hello:
            x-swagger-router-controller: hello_world

./api/controllers

./api/controllers/hello_world.js

{
    "name": "swagger_api_test",
    "author": {
        "name": "xgqfrms"
    },
    "version": "1.0.0",
    "description": "swagger_api_test",
    "license": "MIT",
    "scripts": {
        "app": "npm run server"
    }
}

[xgqfrms]

Swagger

Swagger is a set of open-source tools built around the OpenAPI Specification that can help you design, build, document and consume REST APIs.

https://github.com/swagger-api

https://github.com/swagger-api/swagger-samples

https://github.com/swagger-api/swagger-node

https://github.com/swagger-api/swagger-js

UI

https://github.com/swagger-api/swagger-ui

https://swagger.io/swagger-ui/

https://swagger.io/download-swagger-ui/

editor

https://editor.swagger.io/

API

https://swapi.co/api/people

https://inspector.swagger.io/builder?url=https%3A%2F%2Fswapi.co%2Fapi%2Fpeople

https://swagger.io/

https://generator.swagger.io/

docs

https://swagger.io/docs/

https://swagger.io/docs/specification/about/

https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md

https://swagger.io/docs/swagger-tools/#usage-34

https://petstore.swagger.io/
https://petstore.swagger.io/v2/swagger.json

swaggerhub

Design, Build, and Document APIs in the Cloud with SwaggerHub

https://swaggerhub.com/
https://app.swaggerhub.com/

Create New APIs
Document APIs
Share and Collaborate

https://app.swaggerhub.com/apis/xgqfrms/test/1.0.0

[xgqfrms]

new swagger

# install CLI
$ npm i -g swagger

# create a new swagger project
$ swagger project create api-app

# editor API
$ swagger project edit api-app


# run server
$ swagger project start api-app


# call api
$ curl http://127.0.0.1:10010/hello?name=xgqfrms
# { "message": "Hello, xgqfrms!" }

controller

function hello(req, res) {
    var name = req.swagger.params.name.value || 'stranger';
    var hello = util.format('Hello, %s!', name);
    res.json({"message": hello});
}

    paths:
        /hello:
            x-swagger-router-controller: hello_world

./api/controllers

./api/controllers/hello_world.js

{
    "name": "swagger_api_test",
    "author": {
        "name": "xgqfrms"
    },
    "version": "1.0.0",
    "description": "swagger_api_test",
    "license": "MIT",
    "scripts": {
        "app": "npm run server"
    }
}

[xgqfrms]

typo bug

swagger-api/swagger-node#562

# install CLI
$ npm i -g swagger

# create a new swagger project
$ swagger project create api-app

# editor API
$ swagger project edit api-app


# run server
$ swagger project start api-app


# call api
$ curl http://127.0.0.1:10010/hello?name=xgqfrms
# { "message": "Hello, xgqfrms!" }

[xgqfrms]

zh-Hans

文档

https://zhuanlan.zhihu.com/p/21353795

https://zhuanlan.zhihu.com/p/22824372

---

http://maples7.com/2016/09/06/build-doc-system-of-express-api-server-with-swagger/

http://slides.maples7.com/2017-1.html#/

https://zhuanlan.zhihu.com/p/20034107

http://clojure-liberator.github.io/liberator/doc/decisions.html

https://blog.xiaomo.info/2016/JavaSpringBootSwaggerUi/

http://www.cnblogs.com/yanweidie/p/5709113.html

http://helei112g.github.io/swagger-ui/#!/pet/addPet

https://blog.csdn.net/hel12he/article/details/46547863

https://www.jianshu.com/p/d6626e6bd72c/

http://www.cnblogs.com/woshimrf/p/5863318.html

tools

https://developers.google.com/+/web/api/rest/#partial-response

https://devdocs.io/

[xgqfrms]

how to disable after submit form default refresh page ?

如何禁用 提交 form 后刷新

https://stackoverflow.com/questions/7803814/prevent-refresh-of-page-when-button-inside-form-clicked

https://stackoverflow.com/questions/4194207/prevent-user-from-seeing-previously-visited-secured-page-after-logout

<!DOCTYPE html>
<html lang="zh-Hans">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>POST & upload file</title>
</head>

<body>
    <section>
        <form action='http://127.0.0.1:8080/users?key={"name":"abc"}' method='POST' enctype="multipart/form-data">
            <!-- <form action='http://127.0.0.1:8080/users?{"name":"abc"}' method='POST' enctype="multipart/form-data"> -->
            <!-- <form action='http://127.0.0.1:8080/users?name=abc' method='POST' enctype="multipart/form-data"> -->
            <input type='file' name='uploadfile' />
            <input type="name" value="xgqfrms" />
            <input type="submit" value="提交" onclick="notSubmit()" />
        </form>
        <button type="submit">提交</button>
    </section>
    <!-- js -->
    <script>
        const notSubmit = () => {
            return false;
        };
    </script>
</body>

</html>

---

https://imququ.com/post/four-ways-to-post-data-in-http.html

http://www.cnblogs.com/fish-li/archive/2011/07/17/2108884.html#_label3

http://www.jb51.net/web/447549.html
http://www.jb51.net/article/98618.htm

[xgqfrms]

https://flaviusmatis.github.io/simplePagination.js/

https://github.com/flaviusmatis/simplePagination.js

http://listjs.com/docs/plugins/pagination/

https://github.com/javve/list.js

http://listjs.com/examples/pagination/

http://listjs.com/examples/table/

https://codepen.io/search/pens?q=pagination&limit=all&type=type-pens

https://codepen.io/search/pens?q=table&order=popularity&depth=everything&show_forks=false

Javascript Pagination

https://codepen.io/karpovsystems/pen/fFHxK

https://codepen.io/simeydotme/pen/GrEoH

https://codepen.io/RRoberts/pen/jVOWEQ
https://codepen.io/FernE97/pen/zDpwo
https://codepen.io/vineethtr/pen/MYBeyB

https://www.sitepoint.com/jquery-pagination-plugins/

https://www.w3schools.com/bootstrap/bootstrap_pagination.asp

https://www.w3schools.com/howto/howto_css_pagination.asp

https://www.w3schools.com/css/css3_pagination.asp

FIXED TABLE HEADER

https://codepen.io/nikhil8krishnan/pen/WvYPvv

https://codepen.io/lukepeters/pen/bfFur

https://codepen.io/ashblue/pen/mCtuA

https://codepen.io/alassetter/pen/cyrfB

https://codepen.io/geoffyuen/pen/FCBEg

https://css-tricks.com/complete-guide-table-element/

https://css-tricks.com/fixing-tables-long-strings/

https://designshack.net/articles/10-css-table-examples/

https://www.smashingmagazine.com/2008/08/top-10-css-table-designs/

👋

CodePen is a social development environment for front-end designers and developers.