API– tag –
-
バックエンド
起動しただけでは動き続けない — Backendの到達作品
サーバー・API・データベース・認証をひととおり読んだあと、「じゃあ何か作って」と言われて手が止まりました。知識と、動く1本を作り切ることは別だからです。この記事は Backend コースの到達点として、ログイン付きの小さなAPI(登録・ログイン・自分のメモをCRUD)を、Express と SQLite で作ります。そして最後に、いちばんの山場——node app.js を手で起動しただけでは SSH を切ると止まる、という壁を越え、systemd で常駐させ、nginx で外から叩ける形にして締めます。「動く」で終わらせず、「動き続ける」まで持っていきます。 -
バックエンド
1画面のために3回叩く — GraphQLとRESTの違い
一覧画面を1つ作るのに、いまのREST APIは何回叩くことになるのか。実際に数えて、過剰取得と不足取得を目で見るところから始めます。GraphQLは「1つのURLにPOSTするだけ」でRESTと同じHTTPの上に乗っていること、スキーマが契約になること、既存のRESTを消さずに /graphql を足す実装、そしてGraphQLが極端にN+1を起こしやすいことを101本のSQLログで確かめます。最後に、失われるもの(HTTPキャッシュ・エラーが200で返る・認可が複雑になる)を正直に並べて、個人のサービスならRESTで十分だという結論まで書きます。 -
バックエンド
APIの正体はJSONを返すHTTP — Node.jsで作る
前回の15行のサーバーを、そのままAPIに育てる。生のNodeでPOSTの本文を受け取り、第3段階で「フロントでは直せない」と書いたCORSを今度はサーバー側から解除する。最後にExpressで書き直して、ライブラリが何を肩代わりしていたのかを確かめる。 -
バックエンド
URLに動詞を入れない — REST APIの設計
/api/deleteTask?id=3 と書きたくなるのを、なぜ DELETE /api/tasks/3 にするのか。URLはモノ、メソッドが動詞。PUTとPATCHの違い、2回打っても壊れない設計(冪等性)、そして「無いIDを消したとき何を返すか」まで、前回のtasks APIを完成させながら決めていきます。
1