akinoriosamura / QaAppServer

0 stars 0 forks source link

API #10

Open akinoriosamura opened 6 years ago

akinoriosamura commented 6 years ago

JSON schema からAPIのドキュメント作ったりすることができるっぽいですね。

でJSON schemaなのでテストに組み込むことができて、APIが正しいJSONを吐いているのか検証することができるという感じです。 http://tech.degica.com/ja/2015/10/16/json-schema-ja/

akinoriosamura commented 6 years ago

Json schema

一連 https://qiita.com/arumi8go/items/a9530cbd39ff545a7bbb http://tech.degica.com/ja/2015/10/16/json-schema-ja/https://komoju.com/api/v1/schema.json https://qiita.com/meta_closure/items/edc0abc704f9ade37cc5 クライアントライブラリ

yamlドキュメンと、APIレスポンス検証 https://qiita.com/sagaraya/items/115c15c0df3e84ecbc7f schemaのキーワードref https://spacetelescope.github.io/understanding-json-schema/reference/type.html prmd一連とverify(schemaに間違いがないか確認)の難点 https://qiita.com/taizo/items/2528c16a2a48deb1c2e5 prmd一連 https://qiita.com/fakestarbaby/items/90144d8bc3dead46e65c ペパボの例:全体 http://sssslide.com/speakerdeck.com/kenchan/real-world-json-hyper-schema

akinoriosamura commented 6 years ago

meta.jsonを

---
"$schema": http://json-schema.org/draft-04/hyper-schema

のみだけでも良いので作成して、combinedしないとエラーが出る

akinoriosamura commented 6 years ago

バリデーション

json-schemaでテスト https://ota42y.com/blog/2016/12/19/finc-advent/ https://qiita.com/tbpgr/items/67b1ea1a605434afb743 http://tech.degica.com/ja/2015/10/16/json-schema-ja/

一通りのフロー https://qiita.com/p__oka/items/e5b0b6437fee045d6252

akinoriosamura commented 6 years ago

APIのおさらい

https://blog.onk.ninja/2017/09/21/review_of_restful_api