JSON APIを実装する仕事を最近はよくしています。 普段 Rails で開発していて、モバイルアプリ向けにいわゆるフツウにJSONで返す Web API を実装しています。 URLやインターフェースを設計して、それに合わせて rspec でテストを書いて中身を実装する流れで開発することが多い。 今回は、実装するときにテストを書くだけでなく、必ず 目視で APIのレスポンスをチェックするようにしてから、バグやミスが減ったということを紹介したい。*1 目視で確認する たとえば、レストランのメニューを表示するようなAPIを作ってるとして、rspec (reques spec) を書いたとする。 describe 'GET /menu/:id' do let(:menu) { create(:menu) } subject(:submit_request) { get "/menu/#{men