swagger
イシュー
- API作る
- Swagger は、フロントエンドプログラマー向けのツール。
- フロントエンドプログラマーが、サーバーサイドのAPIが完成する前に、モックを作るためのツール
- GitHub - swagger-api/swagger-node: Swagger module for node.js
参考
- The Best APIs are Built with Swagger Tools | Swagger
- Swaggerの概要をまとめてみた。 - Qiita
- 開発効率を上げる!Swaggerで作るWEB APIモック - ZOZO Technologies TECH BLOG
- swagger記法について解説あり
- SwaggerHub がSwagger Editor よりも機能豊富
- swagger-node を使って API ドキュメントとスタブサーバーを作成する | DevelopersIO
- SwaggerでAPIを定義してインタラクティブAPIドキュメントを見る - Qiita
- serverless frameworkでswaggerで定義したAPI GatewayとLambdaをデプロイする方法 - Qiita
- SwaggerでRESTful APIの管理を楽にする - Qiita
- 内容がまとまってそう
- 開発効率を上げる!Swaggerで作るWEB APIモック - Qiita
- Swagger 3.0のOAuth認証にCognito User PoolsのOAuth Clientを使う | DevelopersIO
apiblueprint
tool群
- Swagger Editor
- swagger の yaml を作るエディタ
- Docker Hub
- docker をチェックアウトするだけで使える
- OpenAPI Specification | Swagger
- swagger の仕様
- SwaggerでRESTful APIの管理を楽にする - Qiita
- swagger についてよくまとまっている。
- Swaggerを使ってモックサーバを立てるまでの手順 - Qiita
- swagger-node を使っているサンプル
- もう管理画面のフロントコードを書く必要はありません、そう Viron ならね。 - Qiita
- rion?
viron
- swagger 使えば、サーバとクライアントのコードが生成できるんじゃないの?と思うのだが、、コード生成だけじゃ足りないから?
- docker-composeで配信されとる、結構めんどい
参考
- Viron
- 全ての管理画面開発に悩めるエンジニアに捧ぐ 〜Viron誕生〜(シーエー・モバイル) - CAM TECH BLOG
- 全サーバエンジニアにおすすめ!VIRONで楽々管理画面作成! - ブロックチェーンエンジニアとして生きる
- CA Mobileはサイバーエージェントの子会社
- Vironとgoaをセキュリティのことは一旦忘れて試してみた - istyle Tech Blog
- https 必須は辛いから http
- GitHub - cam-inc/viron: ☕️ Automated Design-based Management Console.
OAS2.0
- Open API Specification
swagger-node のサーバーに何を使おうか
- プロジェクト作成時に、以下が選べる
- connect
- express
- hapi
- restify
- sails
connect
- Node.jsをとりあえず始めるにあたって現実的に必要だった知識 - Qiita
- GitHub - senchalabs/connect: Connect is a middleware layer for Node.js
express
- Swagger x Heroku で手軽に API モック&ドキュメントを作る - Qiita
- swagger x heroku
hapi
- Node.jsのフレームワークhapiを試してみる - Qiita
- Hapi.jsでHappy Coding - Part1: ルーティングとSwaggerプラグイン - Qiita
- メジャーなNode用Webアプリケーションフレームワークを比較する - Qiita
- GitHub - dwyl/hapi-postgres-connection: Creates a PostgreSQL Connection (Pool) available anywhere in your Hapi App
- https://www.amazon.co.jp/Getting-Started-Hapi-js-Building-Functional/dp/1491926902
- 主要Node.jsフレームワークのメモ - Qiita
- hapi-aws-lambda - npm
- aws で動作させる想定
- star 6
- hapi-lambda - npm
- star 6
- Application Performance Monitoring & Management | AppDynamics
restify
- Restify
- Node.js(restify) + MongoDB(mongoose) でAPIサーバつくってHerokuでデプロイするまで - イッツァハローワールド
- Node.js + MongoDBでAPIサーバつくるまでに勉強したこと - イッツァハローワールド
- Secure a Web API with Azure AD | Microsoft Docs
- https://code.i-harness.com/ja/q/14603bd
- GitHub - kksharma1618/lambda-restify: A restify/expressjs like interface for aws lamda with api gateway event
sailsjs x swagger
- GitHub - trailsjs/sails-swagger: Swagger integration for sails.js
- モックを作ってくれるのはわかったが、APIの実装を行なった場合の役割分担はどうなるのだろう。
- sailsが必要かどうかは、APIサーバにUI(HTML)が必要かどうか。普通はいらん。
- hapiのDB環境が気になる
- Swaggerとswagger-node - Qiita
- GitHub - trailsjs/sails-swagger: Swagger integration for sails.js
- sailsのmodelの内容が、swaggerに反映される
- GitHub - trailsjs/sails-swagger: Swagger integration for sails.js
- sails-swagger.huck には、swagger.config が必要
- json2yaml - npm
- sails.js - Swagger Sails JS - Stack Overflow
- json で出力されるデータが、swagger-ui でJSで表示するという技
- Sails-custom-swagger-hook by jasancheg
serverless x swagger
swagger x aws
- OpenAPI に対する API Gateway 拡張 - Amazon API Gateway
- OpenAPI 定義をインポートしてエッジ最適化 API をセットアップする - Amazon API Gateway
- OpenAPI に対する API Gateway 拡張 - Amazon API Gateway
- SwaggerHub から Amazon API Gateway と AWS Lambda を作成する - Qiita
- 世界に先駆けてAWSサーバレスアーキテクチャでユーザ認証とAPI認可の実装をしてみた - Qiita
swagger x salesforce
swagger-nodeのなぞ
- swagger-node で、モックが作れる。けど、APIは作れない。デザイナ向け?
参考
- https://qiita.com/jooex/items/cae3266f6b0d120facac:tilte
AWS API Client で作成したAPIをswagger hubで公開できる
Swagger Spec
- 今更Swagger Spec + ReDoc + Firebase HostingでAPI仕様ページを作ったら劇的に捗った件について - Qiita
- 開発効率を上げる!Swaggerの記法まとめ - ZOZO Technologies TECH BLOG