The Swagger command-line. Provides Swagger utilities and project lifecycle support.
swagger module provides tools for designing and building Swagger-compliant APIs entirely in Node.js. It integrates with popular Node.js servers, including Express, Hapi, Restify, and Sails, as well as any Connect-based middleware. With
swagger, you can specify, build, and test your API from the very beginning, on your laptop. It allows you to change and iterate your design without rewriting the logic of your implementation.
Remember, one great thing about this approach is that all of the Swagger validation logic is handled for you, and all of the routing logic is managed through the Swagger configuration. You don't have to code (or recode!) any of that stuff yourself.
Install using npm. For complete instructions, see the install page.
$ npm install -g swagger
$ swagger project create hello-world
The interactive, browser-based Swagger Editor is built in. It provides Swagger 2.0 validation and endpoint routing, generates docs on the fly, and consumes easy-to-read YAML.
$ swagger project edit
Code your API's business logic in Node.js.
var name = reqswaggerparamsnamevalue || 'stranger';var hello = utilformat'Hello, %s' name;resjsonhello;
If you look at the Swagger file in the editor (shown in step 3 above), the
x-swagger-router-controller element (line 17 in the editor screenshot) specifies the name of the controller file associated with the
/hello path. For example:
Controller source code is always placed in
./api/controllers. So, the controller source file for this project is
operationId element specifies which controller function to call. In this case (line 19), it is a function called
hello. Learn more.
Run the project server.
$ swagger project start
It just works!
$ curl"Hello, Scott!"
See the Installing swagger for details.
Go to the swagger module doc page. It includes all the information you need to get started.
This initiative grew out of Apigee-127, an API design-first development framework using Swagger. Apigee donated the code to create the swagger-node project in 2015.
Copyright 2015 Apigee Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.