Skip to content

Api をドキュメントで管理して github を使って運用し、サーバーとクライアントの開発を分ける

Notifications You must be signed in to change notification settings

numanomanu/api_document_sample

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

api spec

生成されるドキュメント

record10

開発サーバーを立ててリクエストする例

record10

spec

  • node_version: v8.1.2
  • yarn v1.3.2

install

$ cd /path/to/this/
$ yarn

書き方

  • api blue print の形式で書いてください。
  • 書き終わったら以下のコマンドを実行し、 index.html を生成してください。
$ yarn run build
$ open index.html

mock サーバーの立ち上げ

mock server を立ち上げることで、 api サーバーが完成する前に、json のやりとりができます。

$ yarn run dev_server

localhost:3002 番にサーバーが立ち上がるように設定しています。

リクエスト例

POST: /items
curl -H "Content-Type: application/json" -X POST -d '{"title":"カバン"}' http://localhost:3002/items/

GET: /items
curl -H "Content-Type: application/json" -X GET http://localhost:3002/items

PUT: /items/1
curl -H "Content-Type: application/json" -X PUT -d '{"title": "綺麗なカバン"}' http://localhost:3002/items/1

参考資料

About

Api をドキュメントで管理して github を使って運用し、サーバーとクライアントの開発を分ける

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published