{"id":2654,"date":"2026-10-24T08:47:25","date_gmt":"2026-10-24T08:47:25","guid":{"rendered":"https:\/\/wayhope.kro.kr\/?p=2654"},"modified":"2026-10-24T08:47:25","modified_gmt":"2026-10-24T08:47:25","slug":"rest-api-%ec%84%a4%ea%b3%84-%ec%9b%90%ec%b9%99%ea%b3%bc-%ec%8b%a4%eb%ac%b4-%ea%b5%ac%ed%98%84","status":"publish","type":"post","link":"https:\/\/wayhope.kro.kr\/?p=2654","title":{"rendered":"REST API \uc124\uacc4 \uc6d0\uce59\uacfc \uc2e4\ubb34 \uad6c\ud604"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">REST API\ub780?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">REST(Representational State Transfer)\ub294 \ub124\ud2b8\uc6cc\ud06c\ub97c \ud1b5\ud574 \ub9ac\uc18c\uc2a4\ub97c \ub2e4\ub8e8\uae30 \uc704\ud55c \uc544\ud0a4\ud14d\ucc98 \uc2a4\ud0c0\uc77c\uc774\ub2e4. REST API\ub294 \uc774\ub7ec\ud55c \uc6d0\uce59\uc744 HTTP \ud504\ub85c\ud1a0\ucf5c\uc5d0 \uc801\uc6a9\ud574 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84\uac00 \ub370\uc774\ud130\ub97c \uc8fc\uace0\ubc1b\ub3c4\ub85d \uc124\uacc4\ud55c \uc778\ud130\ud398\uc774\uc2a4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c \uc720\uc800 \uc815\ubcf4, \uc778\ubca4\ud1a0\ub9ac, \uac8c\uc784 \uae30\ub85d\uc744 \uad00\ub9ac\ud55c\ub2e4\uace0 \uac00\uc815\ud558\uc790. \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 HTTP \uc694\uccad\uc744 \ud1b5\ud574 \uc720\uc800 \uc815\ubcf4\ub97c \uc870\ud68c\ud558\uac70\ub098 \uc544\uc774\ud15c\uc744 \uc0ac\uc6a9\ud558\uace0 \uac8c\uc784 \uae30\ub85d\uc744 \ud655\uc778\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">REST API\ub97c \uc124\uacc4\ud560 \ub54c \uc911\uc694\ud55c \uac83\uc740 \ub2e8\uc21c\ud788 URL\uc744 \ub9cc\ub4dc\ub294 \uac83\uc774 \uc544\ub2c8\ub2e4. <strong>\ub9ac\uc18c\uc2a4\uc758 \uc758\ubbf8, HTTP \uba54\uc11c\ub4dc\uc758 \uc5ed\ud560, \ub370\uc774\ud130 \uac80\uc99d, \uc624\ub958 \ucc98\ub9ac, \ud638\ud658\uc131 \ub4f1\uc744 \uc77c\uad00\ub41c \uaddc\uce59\uc73c\ub85c \uc815\uc758\ud558\ub294 \uac83<\/strong>\uc774 \ud575\uc2ec\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ubc88 \uae00\uc5d0\uc11c\ub294 REST API\uc758 \uc8fc\uc694 \uc124\uacc4 \uc6d0\uce59\uacfc Node.js, Express, TypeScript \ud658\uacbd\uc5d0\uc11c\uc758 \uad6c\ud604 \ubc29\ubc95\uc744 \uc0b4\ud3b4\ubcf8\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ub9ac\uc18c\uc2a4 \uc911\uc2ec URL \uc124\uacc4<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">REST API\uc5d0\uc11c URL\uc740 \uc77c\ubc18\uc801\uc73c\ub85c \ub9ac\uc18c\uc2a4\ub97c \uc2dd\ubcc4\ud558\ub294 \uc5ed\ud560\uc744 \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub9ac\uc18c\uc2a4\ub780 \uc11c\ubc84\uac00 \uad00\ub9ac\ud558\ub294 \ub370\uc774\ud130\ub098 \uac1c\ub150\uc744 \uc758\ubbf8\ud55c\ub2e4. \uc0ac\uc6a9\uc790, \uc0c1\ud488, \uc778\ubca4\ud1a0\ub9ac, \uc8fc\ubb38, \uac8c\uc784 \uae30\ub85d \ub4f1\uc774 \ub300\ud45c\uc801\uc778 \uc608\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub3d9\uc0ac\ubcf4\ub2e4 \uba85\uc0ac\ub97c \uc0ac\uc6a9\ud55c\ub2e4<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\uc74c\uacfc \uac19\uc740 URL\uc744 \uc0dd\uac01\ud574 \ubcf4\uc790.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/getUser\/123\nPOST \/createUser\nPOST \/deleteUser\/123<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubc29\uc2dd\uc740 URL\uc5d0 \uc791\uc5c5\uc758 \uc758\ubbf8\ub97c \uc9c1\uc811 \ud3ec\ud568\ud55c\ub2e4. \ud558\uc9c0\ub9cc HTTP \uba54\uc11c\ub4dc \uc790\uccb4\uac00 \uc791\uc5c5\uc758 \uc131\uaca9\uc744 \ub098\ud0c0\ub0b4\ubbc0\ub85c URL\uc5d0\ub294 \ub9ac\uc18c\uc2a4\ub97c \uc911\uc2ec\uc73c\ub85c \ud45c\ud604\ud558\ub294 \ud3b8\uc774 \uc77c\uad00\uc801\uc774\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET    \/users\/123\nPOST   \/users\nDELETE \/users\/123<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uac01 URL\uc758 \uc758\ubbf8\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>GET \/users\/123<\/code>: \ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc870\ud68c<\/li>\n\n\n\n<li><code>POST \/users<\/code>: \uc0ac\uc6a9\uc790 \uc0dd\uc131<\/li>\n\n\n\n<li><code>DELETE \/users\/123<\/code>: \ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc0ad\uc81c<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">URL\uc740 \ub9ac\uc18c\uc2a4\ub97c \uc2dd\ubcc4\ud558\uace0, HTTP \uba54\uc11c\ub4dc\ub294 \ud574\ub2f9 \ub9ac\uc18c\uc2a4\uc5d0 \uc218\ud589\ud560 \uc791\uc5c5\uc744 \ud45c\ud604\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uceec\ub809\uc158\uacfc \uac1c\ubcc4 \ub9ac\uc18c\uc2a4\ub97c \uad6c\ubd84\ud55c\ub2e4<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5ec\ub7ec \ub9ac\uc18c\uc2a4\ub97c \ub098\ud0c0\ub0b4\ub294 \uceec\ub809\uc158\uacfc \ud2b9\uc815 \ub9ac\uc18c\uc2a4\ub97c \ub098\ud0c0\ub0b4\ub294 URL\uc744 \uad6c\ubd84\ud558\uba74 API\uc758 \uad6c\uc870\uac00 \uba85\ud655\ud574\uc9c4\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\ubaa9\uc801<\/th><th>HTTP \uc694\uccad<\/th><\/tr><tr><td>\uc804\uccb4 \uc0ac\uc6a9\uc790 \uc870\ud68c<\/td><td><code>GET \/users<\/code><\/td><\/tr><tr><td>\ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc870\ud68c<\/td><td><code>GET \/users\/123<\/code><\/td><\/tr><tr><td>\uc0ac\uc6a9\uc790 \uc0dd\uc131<\/td><td><code>POST \/users<\/code><\/td><\/tr><tr><td>\ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc218\uc815<\/td><td><code>PATCH \/users\/123<\/code><\/td><\/tr><tr><td>\ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc0ad\uc81c<\/td><td><code>DELETE \/users\/123<\/code><\/td><\/tr><tr><td>\ud2b9\uc815 \uc0ac\uc6a9\uc790\uc758 \uc778\ubca4\ud1a0\ub9ac \uc870\ud68c<\/td><td><code>GET \/users\/123\/inventory<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\ud558\uc704 \ub9ac\uc18c\uc2a4\ub294 \uc0c1\uc704 \ub9ac\uc18c\uc2a4\uc640\uc758 \uad00\uacc4\ub97c \ud45c\ud604\ud560 \ub54c \uc720\uc6a9\ud558\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub9cc \ubaa8\ub4e0 \uad00\uacc4\ub97c \uc911\ucca9 URL\ub85c \ud45c\ud604\ud560 \ud544\uc694\ub294 \uc5c6\ub2e4. \uc911\ucca9\uc774 \uc9c0\ub098\uce58\uac8c \uae4a\uc5b4\uc9c0\uba74 URL\uc774 \ubcf5\uc7a1\ud574\uc9c0\uace0 \ub9ac\uc18c\uc2a4\uc758 \ub3c5\ub9bd\uc801\uc778 \uc811\uadfc\ub3c4 \uc5b4\ub824\uc6cc\uc9c4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \ub2e4\uc74c URL\uc740 \uc9c0\ub098\uce58\uac8c \ubcf5\uc7a1\ud558\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/users\/123\/games\/456\/rooms\/789\/items\/10<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc544\uc774\ud15c\uc774 \ub3c5\ub9bd\uc801\uc778 \ub9ac\uc18c\uc2a4\ub77c\uba74 \ub2e4\uc74c\uacfc \uac19\uc774 \ud45c\ud604\ud558\ub294 \ubc29\ubc95\ub3c4 \uace0\ub824\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/items\/10<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5b4\ub5a4 URL\uc774 \uc801\uc808\ud55c\uc9c0\ub294 \ub370\uc774\ud130\uc758 \uc2e4\uc81c \uad00\uacc4\uc640 \ub9ac\uc18c\uc2a4\uc758 \ub3c5\ub9bd\uc131\uc5d0 \ub530\ub77c \uacb0\uc815\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud544\ud130\ub9c1, \uc815\ub82c, \ud398\uc774\uc9c0\ub124\uc774\uc158\uc740 \ucffc\ub9ac \ud30c\ub77c\ubbf8\ud130\ub85c \ud45c\ud604\ud55c\ub2e4<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uceec\ub809\uc158\uc5d0\uc11c \ud2b9\uc815 \uc870\uac74\uc5d0 \ud574\ub2f9\ud558\ub294 \ub370\uc774\ud130\ub9cc \uc870\ud68c\ud560 \ub54c\ub294 \ucffc\ub9ac \ud30c\ub77c\ubbf8\ud130\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/users?status=active\nGET \/users?sort=createdAt&amp;order=desc\nGET \/users?page=2&amp;limit=20\nGET \/users?status=active&amp;sort=createdAt&amp;order=desc&amp;page=2&amp;limit=20<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">URL \uacbd\ub85c\ub294 \ub9ac\uc18c\uc2a4\ub97c \uc2dd\ubcc4\ud558\uace0, \ucffc\ub9ac \ud30c\ub77c\ubbf8\ud130\ub294 \uc870\ud68c \uc870\uac74\uc744 \uc9c0\uc815\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \uaddc\uce59\uc744 \ud1b5\uc77c\ud558\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 API\ub97c \uc608\uce21\ud558\uae30 \uc26c\uc6cc\uc9c0\uace0 \uc11c\ubc84\uc5d0\uc11c\ub3c4 \uacf5\ud1b5 \uc870\ud68c \ub85c\uc9c1\uc744 \uad6c\ud604\ud558\uae30 \ud3b8\ud574\uc9c4\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">HTTP \uba54\uc11c\ub4dc\uc640 \uc0c1\ud0dc \ucf54\ub4dc<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">REST API\uc5d0\uc11c\ub294 HTTP \uba54\uc11c\ub4dc\uc640 \uc0c1\ud0dc \ucf54\ub4dc\ub97c \uc801\uc808\ud558\uac8c \uc0ac\uc6a9\ud558\ub294 \uac83\uc774 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">HTTP \uba54\uc11c\ub4dc\ub294 \uc694\uccad\uc758 \ubaa9\uc801\uc744 \ud45c\ud604\ud558\uace0, \uc0c1\ud0dc \ucf54\ub4dc\ub294 \uc694\uccad\uc758 \ucc98\ub9ac \uacb0\uacfc\ub97c \ud45c\ud604\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc8fc\uc694 HTTP \uba54\uc11c\ub4dc<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uba54\uc11c\ub4dc<\/th><th>\uc5ed\ud560<\/th><th>\uc8fc\uc694 \ud2b9\uc9d5<\/th><\/tr><tr><td><code>GET<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc870\ud68c<\/td><td>\uc11c\ubc84 \uc0c1\ud0dc\ub97c \ubcc0\uacbd\ud558\uc9c0 \uc54a\uc544\uc57c \ud568<\/td><\/tr><tr><td><code>POST<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc0dd\uc131 \ub610\ub294 \uc791\uc5c5 \uc2e4\ud589<\/td><td>\ub3d9\uc77c \uc694\uccad\uc758 \ubc18\ubcf5\uc774 \uc911\ubcf5 \uc791\uc5c5\uc744 \ub9cc\ub4e4 \uc218 \uc788\uc74c<\/td><\/tr><tr><td><code>PUT<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc804\uccb4 \uad50\uccb4<\/td><td>\ub3d9\uc77c\ud55c \uc694\uccad\uc744 \ubc18\ubcf5\ud574\ub3c4 \uc758\ub3c4\ud55c \ucd5c\uc885 \uc0c1\ud0dc\uac00 \uac19\uc544\uc57c \ud568<\/td><\/tr><tr><td><code>PATCH<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc77c\ubd80 \uc218\uc815<\/td><td>\ubcc0\uacbd\ud560 \ud544\ub4dc\ub9cc \uc804\ub2ec \uac00\ub2a5<\/td><\/tr><tr><td><code>DELETE<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc0ad\uc81c<\/td><td>\ub3d9\uc77c \uc694\uccad\uc744 \ubc18\ubcf5\ud574\ub3c4 \ucd5c\uc885 \uc0ad\uc81c \uc0c1\ud0dc\uac00 \uc720\uc9c0\ub418\uc5b4\uc57c \ud568<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5ec\uae30\uc11c \uc911\uc694\ud55c \uac1c\ub150\uc740 <strong>\uba71\ub4f1\uc131(Idempotency)<\/strong> \uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uba71\ub4f1\uc131\uc740 \ub3d9\uc77c\ud55c \uc694\uccad\uc744 \uc5ec\ub7ec \ubc88 \uc218\ud589\ud558\ub354\ub77c\ub3c4 \uc11c\ubc84\uc5d0 \ubc18\uc601\ub418\ub294 \ucd5c\uc885 \uc0c1\ud0dc\uac00 \uac19\ub2e4\ub294 \uc758\ubbf8\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>GET<\/code>, <code>PUT<\/code>, <code>DELETE<\/code>\ub294 HTTP \uc758\ubbf8\uc0c1 \uba71\ub4f1\uc131\uc744 \uac00\uc838\uc57c \ud55c\ub2e4. \ubc18\uba74 <code>POST<\/code>\ub294 \uc77c\ubc18\uc801\uc73c\ub85c \uba71\ub4f1\ud558\uc9c0 \uc54a\uc9c0\ub9cc, \uacb0\uc81c\ub098 \uc8fc\ubb38 \uc0dd\uc131 API\uc5d0 \uba71\ub4f1\uc131 \ud0a4\ub97c \ub3c4\uc785\ud558\uba74 \uc911\ubcf5 \ucc98\ub9ac\ub97c \ubc29\uc9c0\ud558\ub3c4\ub85d \uc124\uacc4\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uacb0\uc81c \uc694\uccad\uc744 \ubcf4\ub0b8 \ub4a4 \uc751\ub2f5\uc744 \ubc1b\uc9c0 \ubabb\ud588\ub2e4\uace0 \uac00\uc815\ud558\uc790. \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uac19\uc740 \uc694\uccad\uc744 \ub2e4\uc2dc \ubcf4\ub0b4\uba74 \uacb0\uc81c\uac00 \ub450 \ubc88 \ucc98\ub9ac\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \ub2e4\uc74c\uacfc \uac19\uc774 \uc694\uccad\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST \/payments\nIdempotency-Key: 7e9c1f20-unique-request-id\nContent-Type: application\/json<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\ub294 \ud574\ub2f9 \ud0a4\uc640 \ucc98\ub9ac \uacb0\uacfc\ub97c \uc800\uc7a5\ud558\uace0 \ub3d9\uc77c\ud55c \ud0a4\ub85c \ub4e4\uc5b4\uc628 \uc694\uccad\uc5d0 \ub300\ud574 \uae30\uc874 \uacb0\uacfc\ub97c \ubc18\ud658\ud558\ub3c4\ub85d \uad6c\ud604\ud560 \uc218 \uc788\ub2e4. \uc2e4\uc81c \uacb0\uc81c \ucc98\ub9ac\uc5d0\uc11c\ub294 \ud0a4\uc758 \uc720\ud6a8 \ubc94\uc704, \ub3d9\uc2dc \uc694\uccad \uc81c\uc5b4, \uacb0\uacfc \ubcf4\uc874 \uae30\uac04\ub3c4 \ud568\uaed8 \uc815\uc758\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc8fc\uc694 HTTP \uc0c1\ud0dc \ucf54\ub4dc<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uc0c1\ud0dc \ucf54\ub4dc<\/th><th>\uc758\ubbf8<\/th><th>\uc0ac\uc6a9 \uc0ac\ub840<\/th><\/tr><tr><td><code>200 OK<\/code><\/td><td>\uc694\uccad \uc131\uacf5<\/td><td>\ub370\uc774\ud130 \uc870\ud68c, \uc218\uc815 \uacb0\uacfc \ubc18\ud658<\/td><\/tr><tr><td><code>201 Created<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc0dd\uc131 \uc131\uacf5<\/td><td>\uc0ac\uc6a9\uc790 \uc0dd\uc131<\/td><\/tr><tr><td><code>202 Accepted<\/code><\/td><td>\ucc98\ub9ac \uc694\uccad \uc811\uc218<\/td><td>\ube44\ub3d9\uae30 \uc791\uc5c5 \uc811\uc218<\/td><\/tr><tr><td><code>204 No Content<\/code><\/td><td>\uc694\uccad \uc131\uacf5, \uc751\ub2f5 \ubcf8\ubb38 \uc5c6\uc74c<\/td><td>\uc0ad\uc81c \uc131\uacf5<\/td><\/tr><tr><td><code>400 Bad Request<\/code><\/td><td>\uc798\ubabb\ub41c \uc694\uccad<\/td><td>JSON \ud615\uc2dd \uc624\ub958, \uc77c\ubc18\uc801\uc778 \uc694\uccad \ud615\uc2dd \uc624\ub958<\/td><\/tr><tr><td><code>401 Unauthorized<\/code><\/td><td>\uc778\uc99d \ud544\uc694 \ub610\ub294 \uc778\uc99d \uc2e4\ud328<\/td><td>\uc720\ud6a8\ud558\uc9c0 \uc54a\uc740 \uc778\uc99d \ud1a0\ud070<\/td><\/tr><tr><td><code>403 Forbidden<\/code><\/td><td>\uc811\uadfc \uad8c\ud55c \uc5c6\uc74c<\/td><td>\ub2e4\ub978 \uc0ac\uc6a9\uc790\uc758 \uad00\ub9ac\uc790 \uae30\ub2a5 \uc811\uadfc<\/td><\/tr><tr><td><code>404 Not Found<\/code><\/td><td>\ub9ac\uc18c\uc2a4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc74c<\/td><td>\uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uc0ac\uc6a9\uc790 \uc870\ud68c<\/td><\/tr><tr><td><code>409 Conflict<\/code><\/td><td>\ub9ac\uc18c\uc2a4 \uc0c1\ud0dc\uc640 \ucda9\ub3cc<\/td><td>\ub2c9\ub124\uc784 \uc911\ubcf5, \uc911\ubcf5 \uc0dd\uc131<\/td><\/tr><tr><td><code>422 Unprocessable Content<\/code><\/td><td>\uc694\uccad \ud615\uc2dd\uc740 \uc774\ud574\ud588\uc73c\ub098 \uc758\ubbf8\uc0c1 \ucc98\ub9ac \ubd88\uac00<\/td><td>\uc720\ud6a8\ud558\uc9c0 \uc54a\uc740 \uc5c5\ubb34 \uaddc\uce59<\/td><\/tr><tr><td><code>429 Too Many Requests<\/code><\/td><td>\uc694\uccad \ud69f\uc218 \uc81c\ud55c \ucd08\uacfc<\/td><td>API Rate Limit \ucd08\uacfc<\/td><\/tr><tr><td><code>500 Internal Server Error<\/code><\/td><td>\uc11c\ubc84 \ub0b4\ubd80 \uc624\ub958<\/td><td>\uc608\uc0c1\ud558\uc9c0 \ubabb\ud55c \uc11c\ubc84 \uc608\uc678<\/td><\/tr><tr><td><code>503 Service Unavailable<\/code><\/td><td>\uc11c\ube44\uc2a4 \uc77c\uc2dc\uc801 \uc774\uc6a9 \ubd88\uac00<\/td><td>\uc11c\ubc84 \uacfc\ubd80\ud558, \uc810\uac80<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0c1\ud0dc \ucf54\ub4dc\ub294 API \uc804\uccb4\uc5d0\uc11c \uc77c\uad00\ub418\uac8c \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \ub2c9\ub124\uc784 \uc911\ubcf5\uc744 \uc5b4\ub5a4 API\uc5d0\uc11c\ub294 <code>400<\/code>, \ub2e4\ub978 API\uc5d0\uc11c\ub294 <code>409<\/code>\ub85c \ubc18\ud658\ud558\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc624\ub958\ub97c \uad6c\ubd84\ud558\uae30 \uc5b4\ub824\uc6cc\uc9c4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2c9\ub124\uc784 \uc911\ubcf5\uc740 \uae30\uc874 \ub9ac\uc18c\uc2a4\uc640 \ucda9\ub3cc\ud558\ub294 \uc0c1\ud669\uc774\ubbc0\ub85c \uc77c\ubc18\uc801\uc73c\ub85c <code>409 Conflict<\/code>\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubc18\uba74 \ub2c9\ub124\uc784 \uaddc\uce59 \uc704\ubc18\uc740 API\uc758 \uc624\ub958 \uc815\ucc45\uc5d0 \ub530\ub77c <code>400<\/code> \ub610\ub294 <code>422<\/code>\ub85c \ud45c\ud604\ud560 \uc218 \uc788\ub2e4. \uc5b4\ub290 \ucf54\ub4dc\ub97c \uc120\ud0dd\ud558\ub4e0 \ud504\ub85c\uc81d\ud2b8 \uc804\uccb4\uc5d0\uc11c \ub3d9\uc77c\ud55c \uc815\ucc45\uc744 \uc720\uc9c0\ud558\ub294 \uac83\uc774 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">DTO\uc640 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \ubaa8\ub378 \ubd84\ub9ac<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">DTO(Data Transfer Object)\ub294 \uacc4\uce35 \uac04\uc5d0 \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud558\uae30 \uc704\ud55c \uac1d\uccb4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub370\uc774\ud130\ubca0\uc774\uc2a4 \ubaa8\ub378\uc740 \uc2e4\uc81c \uc800\uc7a5\uc18c\uc758 \ub370\uc774\ud130 \uad6c\uc870\ub97c \ud45c\ud604\ud55c\ub2e4. \ub450 \uac1d\uccb4\ub294 \ubaa9\uc801\uc774 \ub2e4\ub974\ubbc0\ub85c \uac19\uc740 \uad6c\uc870\ub97c \uc0ac\uc6a9\ud574\uc57c \ud560 \uc774\uc720\uac00 \uc5c6\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \uc0ac\uc6a9\uc790 \ud14c\uc774\ube14\uc774 \ub2e4\uc74c\uacfc \uac19\ub2e4\uace0 \uac00\uc815\ud558\uc790.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>interface UserModel {\n  id: number;\n  email: string;\n  passwordHash: string;\n  nickname: string;\n  role: string;\n  createdAt: Date;\n  updatedAt: Date;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubaa8\ub378\uc5d0\ub294 \uc778\uc99d\uc744 \uc704\ud55c \ube44\ubc00\ubc88\ud638 \ud574\uc2dc\uc640 \ub0b4\ubd80 \uad00\ub9ac \uc815\ubcf4\uac00 \ud3ec\ud568\ub418\uc5b4 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c API \uc751\ub2f5\uc5d0 \uadf8\ub300\ub85c \uc0ac\uc6a9\ud558\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \ubd88\ud544\uc694\ud55c \ub0b4\ubd80 \ub370\uc774\ud130\uac00 \ub178\ucd9c\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \uc694\uccad DTO\uc640 \uc751\ub2f5 DTO\ub97c \ubcc4\ub3c4\ub85c \uc815\uc758\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc694\uccad DTO<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>export interface CreateUserRequestDto {\n  email: string;\n  password: string;\n  nickname: string;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc0ac\uc6a9\uc790\ub97c \uc0dd\uc131\ud560 \ub54c \uc804\ub2ec\ud574\uc57c \ud558\ub294 \ub370\uc774\ud130\ub9cc \uc815\uc758\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc751\ub2f5 DTO<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>export interface UserResponseDto {\n  id: number;\n  email: string;\n  nickname: string;\n  createdAt: string;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\uac00 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \ubc18\ud658\ud560 \ub370\uc774\ud130\ub9cc \uc815\uc758\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ubaa8\ub378\uc744 DTO\ub85c \ubcc0\ud658\ud55c\ub2e4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>interface UserModel {\n  id: number;\n  email: string;\n  passwordHash: string;\n  nickname: string;\n  role: string;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\ninterface UserResponseDto {\n  id: number;\n  email: string;\n  nickname: string;\n  createdAt: string;\n}\n\nfunction toUserResponseDto(\n  user: UserModel\n): UserResponseDto {\n  return {\n    id: user.id,\n    email: user.email,\n    nickname: user.nickname,\n    createdAt: user.createdAt.toISOString(),\n  };\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubcc0\ud658 \ud568\uc218\ub294 \ub0b4\ubd80 \ub370\uc774\ud130 \ubaa8\ub378\uc744 \uc678\ubd80 API \uacc4\uc57d\uc73c\ub85c \ubcc0\ud658\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>passwordHash<\/code>, <code>role<\/code>, <code>updatedAt<\/code>\uc740 \uc751\ub2f5 DTO\uc5d0 \ud3ec\ud568\ud558\uc9c0 \uc54a\uc558\uc73c\ubbc0\ub85c \uc77c\ubc18 \uc0ac\uc6a9\uc790 \uc751\ub2f5\uc73c\ub85c \ub178\ucd9c\ub418\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubb3c\ub860 \uad00\ub9ac\uc790 API\uc5d0\uc11c \uc5ed\ud560 \uc815\ubcf4\uac00 \ud544\uc694\ud558\ub2e4\uba74 \ubcc4\ub3c4\uc758 \uad00\ub9ac\uc790 \uc751\ub2f5 DTO\ub97c \uc815\uc758\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">DTO\ub97c \ubd84\ub9ac\ud558\ub294 \uc774\uc720<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\ubcf4\uc548:<\/strong> \ube44\ubc00\ubc88\ud638 \ud574\uc2dc\uc640 \ub0b4\ubd80 \ud544\ub4dc\uc758 \uc678\ubd80 \ub178\ucd9c \ubc29\uc9c0<\/li>\n\n\n\n<li><strong>\uc720\uc9c0\ubcf4\uc218:<\/strong> \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uad6c\uc870 \ubcc0\uacbd\uc774 API\uc5d0 \ubbf8\uce58\ub294 \uc601\ud5a5 \ucd5c\uc18c\ud654<\/li>\n\n\n\n<li><strong>\uac80\uc99d:<\/strong> \uc694\uccad\ub9c8\ub2e4 \ud5c8\uc6a9\ub418\ub294 \ud544\ub4dc\ub97c \uba85\ud655\ud558\uac8c \uc815\uc758<\/li>\n\n\n\n<li><strong>\ubc84\uc800\ub2dd:<\/strong> API \ubc84\uc804\ubcc4 \uc751\ub2f5 \uad6c\uc870\ub97c \ub3c5\ub9bd\uc801\uc73c\ub85c \uad00\ub9ac<\/li>\n\n\n\n<li><strong>\uacc4\uce35 \ubd84\ub9ac:<\/strong> \ub370\uc774\ud130 \uc800\uc7a5 \uad6c\uc870\uc640 \ud074\ub77c\uc774\uc5b8\ud2b8 \uacc4\uc57d\uc758 \uacb0\ud569\ub3c4 \uac10\uc18c<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ud2b9\ud788 TypeScript\uc758 \ud0c0\uc785 \uc815\uc758\ub9cc\uc73c\ub85c\ub294 \uc2e4\uc81c HTTP \uc694\uccad\uc758 \ub370\uc774\ud130\ub97c \uac80\uc99d\ud560 \uc218 \uc5c6\ub2e4. \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc784\uc758\uc758 JSON\uc744 \ubcf4\ub0bc \uc218 \uc788\uc73c\ubbc0\ub85c \ub7f0\ud0c0\uc784 \uac80\uc99d\uc744 \ubcc4\ub3c4\ub85c \uc218\ud589\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uc785\ub825\uac12 \uac80\uc99d<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcf4\ub0b4\ub294 \ub370\uc774\ud130\ub294 \uc2e0\ub8b0\ud560 \uc218 \uc5c6\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">TypeScript\uc5d0\uc11c \uc694\uccad \uac1d\uccb4\uc758 \ud0c0\uc785\uc744 \uc9c0\uc815\ud558\ub354\ub77c\ub3c4 \uc678\ubd80\uc5d0\uc11c \uc804\ub2ec\ub41c JSON\uc774 \ud574\ub2f9 \ud0c0\uc785\uc744 \uc900\uc218\ud55c\ub2e4\ub294 \ubcf4\uc7a5\uc740 \uc5c6\ub2e4. \ub530\ub77c\uc11c \uc11c\ubc84\uc5d0\uc11c \uc694\uccad \ub370\uc774\ud130\ub97c \uac80\uc99d\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uac80\uc99d\uc740 \ud06c\uac8c \ub2e4\uc74c\uacfc \uac19\uc774 \ub098\ub20c \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\ud615\uc2dd \uac80\uc99d:<\/strong> \ubb38\uc790\uc5f4, \uc22b\uc790, \uc774\uba54\uc77c \ud615\uc2dd, \uae38\uc774<\/li>\n\n\n\n<li><strong>\ud5c8\uc6a9\uac12 \uac80\uc99d:<\/strong> enum\uc5d0 \uc815\uc758\ub41c \uac12\uc778\uc9c0 \ud655\uc778<\/li>\n\n\n\n<li><strong>\uc5c5\ubb34 \uaddc\uce59 \uac80\uc99d:<\/strong> \ub2c9\ub124\uc784 \uc911\ubcf5, \uc794\uc561 \ubd80\uc871 \uc5ec\ubd80<\/li>\n\n\n\n<li><strong>\uad8c\ud55c \uac80\uc99d:<\/strong> \uc694\uccad\ud55c \uc0ac\uc6a9\uc790\uac00 \ud574\ub2f9 \ub9ac\uc18c\uc2a4\ub97c \ubcc0\uacbd\ud560 \uad8c\ud55c\uc774 \uc788\ub294\uc9c0 \ud655\uc778<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Zod\ub97c \uc774\uc6a9\ud55c \ub7f0\ud0c0\uc784 \uac80\uc99d<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Node.js\uc640 TypeScript \ud658\uacbd\uc5d0\uc11c\ub294 Zod \uac19\uc740 \uac80\uc99d \ub77c\uc774\ube0c\ub7ec\ub9ac\ub97c \ud65c\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>import { z } from \"zod\";\n\nexport const createUserSchema = z.object({\n  email: z\n    .string()\n    .trim()\n    .email()\n    .max(254),\n\n  password: z\n    .string()\n    .min(12)\n    .max(128),\n\n  nickname: z\n    .string()\n    .trim()\n    .min(2)\n    .max(20)\n    .regex(\n      \/^&#91;a-zA-Z0-9\uac00-\ud7a3_]+$\/,\n      \"\ub2c9\ub124\uc784 \ud615\uc2dd\uc774 \uc62c\ubc14\ub974\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.\"\n    ),\n}).strict();\n\nexport type CreateUserRequestDto =\n  z.infer&lt;typeof createUserSchema&gt;;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc704 \uc2a4\ud0a4\ub9c8\ub294 \uc774\uba54\uc77c \ud615\uc2dd, \ube44\ubc00\ubc88\ud638 \uae38\uc774, \ub2c9\ub124\uc784 \uaddc\uce59\uc744 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>.strict()<\/code>\ub294 \uc815\uc758\ub418\uc9c0 \uc54a\uc740 \ud544\ub4dc\uac00 \ud3ec\ud568\ub41c \uc694\uccad\uc744 \uac70\ubd80\ud558\ub3c4\ub85d \ud55c\ub2e4. \ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c \uc54c \uc218 \uc5c6\ub294 \ud544\ub4dc\ub97c \ubb34\uc2dc\ud558\uac70\ub098 \uc81c\uac70\ud558\ub294 \uc815\ucc45\uc744 \uc0ac\uc6a9\ud55c\ub2e4\uba74 \uadf8\uc5d0 \ub9de\uac8c \uc124\uc815\ud558\uba74 \ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ube44\ubc00\ubc88\ud638 \uc815\ucc45\uc740 \uc2e4\uc81c \uc11c\ube44\uc2a4\uc758 \ubcf4\uc548 \uc815\ucc45\uc5d0 \ub9de\uac8c \uacb0\uc815\ud574\uc57c \ud558\uba70, \uc785\ub825\uac12 \uac80\uc99d\ub9cc\uc73c\ub85c \ube44\ubc00\ubc88\ud638 \ubcf4\uc548\uc774 \ud655\ubcf4\ub418\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. \ube44\ubc00\ubc88\ud638\ub294 \uc548\uc804\ud55c \ud574\uc2dc \uc54c\uace0\ub9ac\uc998\uc73c\ub85c \ucc98\ub9ac\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Express \ubbf8\ub4e4\uc6e8\uc5b4\uc5d0\uc11c \uac80\uc99d\ud55c\ub2e4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>import { Request, Response, NextFunction } from \"express\";\nimport { z } from \"zod\";\n\nfunction validateBody&lt;T extends z.ZodTypeAny&gt;(\n  schema: T\n) {\n  return (\n    req: Request,\n    res: Response,\n    next: NextFunction\n  ) =&gt; {\n    const result = schema.safeParse(req.body);\n\n    if (!result.success) {\n      return next(\n        new ApiError(\n          422,\n          \"VALIDATION_FAILED\",\n          \"\uc694\uccad \ub370\uc774\ud130\uac00 \uc62c\ubc14\ub974\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.\",\n          result.error.issues.map((issue) =&gt; ({\n            field: issue.path.join(\".\"),\n            message: issue.message,\n          }))\n        )\n      );\n    }\n\n    res.locals.validatedBody = result.data;\n    next();\n  };\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubbf8\ub4e4\uc6e8\uc5b4\ub294 \uc694\uccad \ubcf8\ubb38\uc744 \uac80\uc99d\ud558\uace0, \uac80\uc99d\ub41c \ub370\uc774\ud130\ub9cc \uc774\ud6c4 \ucc98\ub9ac \ub2e8\uacc4\uc5d0 \uc804\ub2ec\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>ApiError<\/code>\ub294 \uc544\ub798\uc5d0\uc11c \uc815\uc758\ud560 \uacf5\ud1b5 \uc624\ub958 \ud074\ub798\uc2a4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub77c\uc6b0\ud130\uc5d0\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc801\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>router.post(\n  \"\/users\",\n  validateBody(createUserSchema),\n  createUserController\n);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ucee8\ud2b8\ub864\ub7ec\ub294 <code>req.body<\/code>\ub97c \uadf8\ub300\ub85c \uc2e0\ub8b0\ud558\ub294 \ub300\uc2e0 <code>res.locals.validatedBody<\/code>\ub97c \uc0ac\uc6a9\ud558\ub3c4\ub85d \uad6c\uc131\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const dto =\n  res.locals.validatedBody as CreateUserRequestDto;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\ubb34\uc5d0\uc11c\ub294 \uac80\uc99d \uacb0\uacfc\uc758 \ud0c0\uc785\uc774 \ucee8\ud2b8\ub864\ub7ec\uae4c\uc9c0 \uc790\uc5f0\uc2a4\ub7fd\uac8c \uc804\ub2ec\ub418\ub3c4\ub85d \ud0c0\uc785 \uc548\uc804\uc131\uc744 \uac15\ud654\ud560 \uc218 \uc788\ub2e4. \uc704 \ucf54\ub4dc\ub294 \ud575\uc2ec \ud750\ub984\uc744 \ubcf4\uc5ec\uc8fc\uae30 \uc704\ud55c \ub2e8\uc21c\ud55c \uc608\uc2dc\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc911\uc694\ud55c \uc810\uc740 \uc785\ub825\uac12 \uac80\uc99d\uc774 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc81c\uc57d \uc870\uac74\uc744 \ub300\uccb4\ud558\uc9c0 \uc54a\ub294\ub2e4\ub294 \uac83\uc774\ub2e4. \ub2c9\ub124\uc784 \uc911\ubcf5 \uac80\uc0ac\ub97c \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \uc218\ud589\ud558\ub354\ub77c\ub3c4 \ub3d9\uc2dc\uc5d0 \ub450 \uc694\uccad\uc774 \ub4e4\uc5b4\uc62c \uc218 \uc788\uc73c\ubbc0\ub85c \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc758 UNIQUE \uc81c\uc57d \uc870\uac74\ub3c4 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uacf5\ud1b5 \uc624\ub958 \uc751\ub2f5 \uc124\uacc4<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">API\ub9c8\ub2e4 \uc624\ub958 \uc751\ub2f5 \uad6c\uc870\uac00 \ub2e4\ub974\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \uc624\ub958 \ucc98\ub9ac \ucf54\ub4dc\uac00 \ubcf5\uc7a1\ud574\uc9c4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \uc5b4\ub5a4 API\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc751\ub2f5\ud558\uace0,<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"message\": \"\ub2c9\ub124\uc784\uc774 \uc911\ubcf5\ub418\uc5c8\uc2b5\ub2c8\ub2e4.\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub978 API\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc751\ub2f5\ud55c\ub2e4\uace0 \uac00\uc815\ud558\uc790.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"error\": \"DUPLICATE_NICKNAME\",\n  \"description\": \"\uc774\ubbf8 \uc0ac\uc6a9 \uc911\uc778 \ub2c9\ub124\uc784\uc785\ub2c8\ub2e4.\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc11c\ub85c \ub2e4\ub978 \uc751\ub2f5 \uad6c\uc870\ub97c \ubaa8\ub450 \ucc98\ub9ac\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \uc624\ub958 \uc751\ub2f5\uc744 \uacf5\ud1b5 \uaddc\uaca9\uc73c\ub85c \ud1b5\uc77c\ud558\ub294 \uac83\uc774 \uc88b\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uacf5\ud1b5 \uc624\ub958 \uc751\ub2f5 \uad6c\uc870<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>export interface ApiErrorResponse {\n  error: {\n    code: string;\n    message: string;\n    details?: Array&lt;{\n      field?: string;\n      message: string;\n    }&gt;;\n    requestId?: string;\n  };\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc751\ub2f5 \uc608\uc2dc\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"error\": {\n    \"code\": \"DUPLICATE_NICKNAME\",\n    \"message\": \"\uc774\ubbf8 \uc0ac\uc6a9 \uc911\uc778 \ub2c9\ub124\uc784\uc785\ub2c8\ub2e4.\",\n    \"details\": &#91;\n      {\n        \"field\": \"nickname\",\n        \"message\": \"\uc0ac\uc6a9\ud560 \uc218 \uc5c6\ub294 \ub2c9\ub124\uc784\uc785\ub2c8\ub2e4.\"\n      }\n    ],\n    \"requestId\": \"req-8f2a1c\"\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uac01 \ud544\ub4dc\uc758 \uc5ed\ud560\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>code<\/code>: \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc624\ub958 \uc720\ud615\uc744 \uc2dd\ubcc4\ud558\ub294 \uae30\uacc4 \ud310\ub3c5\uc6a9 \ucf54\ub4dc<\/li>\n\n\n\n<li><code>message<\/code>: \uc0ac\ub78c\uc774 \uc774\ud574\ud560 \uc218 \uc788\ub294 \uc624\ub958 \uc124\uba85<\/li>\n\n\n\n<li><code>details<\/code>: \ud544\ub4dc\ubcc4 \uac80\uc99d \uc624\ub958 \ub4f1\uc758 \ucd94\uac00 \uc815\ubcf4<\/li>\n\n\n\n<li><code>requestId<\/code>: \uc11c\ubc84 \ub85c\uadf8\uc640 \uc694\uccad\uc744 \uc5f0\uacb0\ud558\uae30 \uc704\ud55c \uc2dd\ubcc4\uc790<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \ubd84\uae30 \ucc98\ub9ac\ub294 \ubcc0\uacbd\ub420 \uc218 \uc788\ub294 \uba54\uc2dc\uc9c0\ubcf4\ub2e4 \uc548\uc815\uc801\uc778 \uc624\ub958 \ucf54\ub4dc\uc5d0 \uc758\uc874\ud558\ub3c4\ub85d \uc124\uacc4\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uacf5\ud1b5 \uc624\ub958 \ud074\ub798\uc2a4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>export class ApiError extends Error {\n  constructor(\n    public readonly statusCode: number,\n    public readonly code: string,\n    message: string,\n    public readonly details?: Array&lt;{\n      field?: string;\n      message: string;\n    }&gt;\n  ) {\n    super(message);\n    this.name = \"ApiError\";\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5c5\ubb34 \ub85c\uc9c1\uc5d0\uc11c \ubc1c\uc0dd\ud55c \uc624\ub958\ub97c <code>ApiError<\/code>\ub85c \ud45c\ud604\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if (existingUser) {\n  throw new ApiError(\n    409,\n    \"DUPLICATE_NICKNAME\",\n    \"\uc774\ubbf8 \uc0ac\uc6a9 \uc911\uc778 \ub2c9\ub124\uc784\uc785\ub2c8\ub2e4.\",\n    &#91;\n      {\n        field: \"nickname\",\n        message: \"\uc774\ubbf8 \uc0ac\uc6a9 \uc911\uc778 \ub2c9\ub124\uc784\uc785\ub2c8\ub2e4.\",\n      },\n    ]\n  );\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Express \uc804\uc5ed \uc624\ub958 \ucc98\ub9ac \ubbf8\ub4e4\uc6e8\uc5b4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>import {\n  Request,\n  Response,\n  NextFunction,\n} from \"express\";\n\nexport function errorHandler(\n  err: unknown,\n  req: Request,\n  res: Response,\n  next: NextFunction\n) {\n  if (res.headersSent) {\n    return next(err);\n  }\n\n  const requestId = res.locals.requestId as\n    | string\n    | undefined;\n\n  if (err instanceof ApiError) {\n    return res.status(err.statusCode).json({\n      error: {\n        code: err.code,\n        message: err.message,\n        ...(err.details\n          ? { details: err.details }\n          : {}),\n        ...(requestId ? { requestId } : {}),\n      },\n    });\n  }\n\n  req.log?.error(\n    { err, requestId },\n    \"Unhandled API error\"\n  );\n\n  return res.status(500).json({\n    error: {\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"\uc11c\ubc84 \ub0b4\ubd80 \uc624\ub958\uac00 \ubc1c\uc0dd\ud588\uc2b5\ub2c8\ub2e4.\",\n      ...(requestId ? { requestId } : {}),\n    },\n  });\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>req.log<\/code>\ub294 \uc694\uccad\ubcc4 \ub85c\uac70\uac00 \uc5f0\uacb0\ub418\uc5b4 \uc788\ub294 \ud658\uacbd\uc744 \uac00\uc815\ud55c \uc608\uc2dc\ub2e4. Pino \ub4f1\uc744 \uc0ac\uc6a9\ud55c\ub2e4\uba74 \uc2e4\uc81c \ub85c\uae45 \ubbf8\ub4e4\uc6e8\uc5b4 \uad6c\uc131\uc5d0 \ub9de\uac8c \uc801\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\uc0c1\ud558\uc9c0 \ubabb\ud55c \uc624\ub958\uc758 \uc0c1\uc138 \ub0b4\uc6a9, SQL \ucffc\ub9ac, \uc2a4\ud0dd \ud2b8\ub808\uc774\uc2a4, \uc778\uc99d \uc815\ubcf4 \ub4f1\uc744 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \ub178\ucd9c\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4. \ud574\ub2f9 \uc815\ubcf4\ub294 \uc11c\ubc84 \ub85c\uadf8\uc5d0\uc11c \ucd94\uc801\ud558\uace0 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\ub294 \uc77c\ubc18\ud654\ub41c \uba54\uc2dc\uc9c0\ub97c \ubc18\ud658\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc804\uc5ed \uc624\ub958 \ubbf8\ub4e4\uc6e8\uc5b4\ub294 \ubaa8\ub4e0 \ub77c\uc6b0\ud130 \ub4f1\ub85d \uc774\ud6c4\uc5d0 \uc5f0\uacb0\ud574\uc57c \ud55c\ub2e4. \ub610\ud55c Express \ubc84\uc804\uc5d0 \ub530\ub77c \ube44\ub3d9\uae30 \uc608\uc678 \uc804\ub2ec \ubc29\uc2dd\uc774 \ub2e4\ub97c \uc218 \uc788\uc73c\ubbc0\ub85c \uc0ac\uc6a9 \uc911\uc778 \ubc84\uc804\uc758 \uc624\ub958 \ucc98\ub9ac \uaddc\uce59\uc744 \uc900\uc218\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud398\uc774\uc9c0\ub124\uc774\uc158\uacfc \uc815\ub82c<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ub370\uc774\ud130\uac00 \ub9ce\uc544\uc9c0\uba74 \uc804\uccb4 \ub370\uc774\ud130\ub97c \ud55c \ubc88\uc5d0 \ubc18\ud658\ud558\ub294 \ubc29\uc2dd\uc740 \ube44\ud6a8\uc728\uc801\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uc11c\ubc84\uc5d0 \uc218\uc2ed\ub9cc \uac1c\uc758 \uc720\uc800 \uae30\ub85d\uc774 \uc800\uc7a5\ub418\uc5b4 \uc788\ub2e4\uba74 \ubaa8\ub4e0 \ub370\uc774\ud130\ub97c \uc870\ud68c\ud558\uace0 \uc804\uc1a1\ud558\ub294 \uac83\uc740 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \ubd80\ud558, \ub124\ud2b8\uc6cc\ud06c \ud2b8\ub798\ud53d, \uba54\ubaa8\ub9ac \uc0ac\uc6a9\ub7c9\uc744 \uc99d\uac00\uc2dc\ud0a8\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ud574\uacb0\ud558\uae30 \uc704\ud574 \ud398\uc774\uc9c0\ub124\uc774\uc158\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Offset \uae30\ubc18 \ud398\uc774\uc9c0\ub124\uc774\uc158<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac00\uc7a5 \uac04\ub2e8\ud55c \ubc29\uc2dd\uc740 <code>page<\/code>\uc640 <code>limit<\/code>\uc744 \uc0ac\uc6a9\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/users?page=2&amp;limit=20<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc870\ud68c\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>SELECT id, nickname, created_at\nFROM users\nORDER BY created_at DESC, id DESC\nLIMIT 20 OFFSET 20;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud398\uc774\uc9c0 \ubc88\ud638\uac00 1\ubd80\ud130 \uc2dc\uc791\ud55c\ub2e4\uace0 \uac00\uc815\ud558\uba74 OFFSET\uc740 \ub2e4\uc74c\uacfc \uac19\uc774 \uacc4\uc0b0\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const page = 2;\nconst limit = 20;\n\nconst offset = (page - 1) * limit;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc7a5\uc810\uc740 \uad6c\ud604\uc774 \ub2e8\uc21c\ud558\uace0 \ud2b9\uc815 \ud398\uc774\uc9c0\ub85c \uc774\ub3d9\ud558\uae30 \uc27d\ub2e4\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubc18\uba74 \ud398\uc774\uc9c0 \ubc88\ud638\uac00 \ucee4\uc9c8\uc218\ub85d \ub370\uc774\ud130\ubca0\uc774\uc2a4\uac00 \ub9ce\uc740 \ud589\uc744 \uac74\ub108\ub6f0\uc5b4\uc57c \ud560 \uc218 \uc788\ub2e4. \ub610\ud55c \uc870\ud68c \ub3c4\uc911 \ub370\uc774\ud130\uac00 \ucd94\uac00\ub418\uac70\ub098 \uc0ad\uc81c\ub418\uba74 \ud398\uc774\uc9c0 \uc0ac\uc774\uc5d0 \uc911\ubcf5 \ub370\uc774\ud130\ub098 \ub204\ub77d\uc774 \ubc1c\uc0dd\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \uc815\ub82c \uae30\uc900\uc744 \uba85\ud655\ud558\uac8c \uc9c0\uc815\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ORDER BY created_at DESC, id DESC<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>created_at<\/code>\uc774 \uac19\uc740 \ub370\uc774\ud130\uac00 \uc874\uc7ac\ud560 \uc218 \uc788\uc73c\ubbc0\ub85c \uace0\uc720\ud55c <code>id<\/code>\ub97c \ubcf4\uc870 \uc815\ub82c \uae30\uc900\uc73c\ub85c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Cursor \uae30\ubc18 \ud398\uc774\uc9c0\ub124\uc774\uc158<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub300\ub7c9\uc758 \ub370\uc774\ud130\ub098 \uc2e4\uc2dc\uac04\uc73c\ub85c \ub370\uc774\ud130\uac00 \ucd94\uac00\ub418\ub294 \ubaa9\ub85d\uc5d0\uc11c\ub294 \ucee4\uc11c \uae30\ubc18 \ud398\uc774\uc9c0\ub124\uc774\uc158\uc774 \uc720\uc6a9\ud558\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/users?limit=20&amp;cursor=eyJpZCI6MTAwMH0<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ucee4\uc11c\ub294 \ub9c8\uc9c0\ub9c9\uc73c\ub85c \uc870\ud68c\ud55c \ub370\uc774\ud130\uc758 \uc704\uce58\ub97c \ub098\ud0c0\ub0b8\ub2e4. \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ud544\uc694\ud55c \uc815\ub82c \uae30\uc900\uacfc \uc2dd\ubcc4\uc790\ub97c \uc778\ucf54\ub529\ud558\uac70\ub098 \ubd88\ud22c\uba85\ud55c \ud1a0\ud070\uc73c\ub85c \uc81c\uacf5\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 <code>created_at<\/code>\uacfc <code>id<\/code>\ub97c \uae30\uc900\uc73c\ub85c \ub0b4\ub9bc\ucc28\uc21c \uc815\ub82c\ud55c\ub2e4\uba74 \ub2e4\uc74c\uacfc \uac19\uc774 \uc870\ud68c\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>SELECT id, nickname, created_at\nFROM users\nWHERE\n  created_at &lt; :lastCreatedAt\n  OR (\n    created_at = :lastCreatedAt\n    AND id &lt; :lastId\n  )\nORDER BY created_at DESC, id DESC\nLIMIT :limit;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubc29\uc2dd\uc740 \uc774\uc804 \ud398\uc774\uc9c0\uc758 \ub9c8\uc9c0\ub9c9 \ub370\uc774\ud130\ubcf4\ub2e4 \ub4a4\uc5d0 \uc788\ub294 \ub370\uc774\ud130\ub97c \uc870\ud68c\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Offset\uacfc Cursor\uc758 \uc120\ud0dd \uae30\uc900<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uae30\uc900<\/th><th>Offset<\/th><th>Cursor<\/th><\/tr><tr><td>\uad6c\ud604 \ub09c\uc774\ub3c4<\/td><td>\ub0ae\uc74c<\/td><td>\uc0c1\ub300\uc801\uc73c\ub85c \ub192\uc74c<\/td><\/tr><tr><td>\ud2b9\uc815 \ud398\uc774\uc9c0 \uc774\ub3d9<\/td><td>\ud3b8\ub9ac\ud568<\/td><td>\uc0c1\ub300\uc801\uc73c\ub85c \ubd88\ud3b8\ud568<\/td><\/tr><tr><td>\ub300\uaddc\ubaa8 \ub370\uc774\ud130<\/td><td>\ud070 OFFSET\uc5d0\uc11c \ube44\ud6a8\uc728\uc801\uc77c \uc218 \uc788\uc74c<\/td><td>\uc801\uc808\ud55c \uc778\ub371\uc2a4\uac00 \uc788\uc73c\uba74 \ud6a8\uc728\uc801<\/td><\/tr><tr><td>\ub370\uc774\ud130 \ubcc0\uacbd\uc5d0 \ub530\ub978 \uc774\ub3d9 \uc548\uc815\uc131<\/td><td>\uc0c1\ub300\uc801\uc73c\ub85c \ub0ae\uc74c<\/td><td>\uc815\ub82c \uae30\uc900\uc5d0 \ub530\ub77c \uc0c1\ub300\uc801\uc73c\ub85c \ub192\uc74c<\/td><\/tr><tr><td>\uc801\ud569\ud55c \uc0ac\ub840<\/td><td>\uad00\ub9ac\uc790 \ubaa9\ub85d, \uc18c\uaddc\ubaa8 \uac80\uc0c9 \uacb0\uacfc<\/td><td>\ud53c\ub4dc, \ub85c\uadf8, \ub300\uaddc\ubaa8 \uac8c\uc784 \uae30\ub85d<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\ucee4\uc11c \uae30\ubc18 \ubc29\uc2dd\ub3c4 \uc790\ub3d9\uc73c\ub85c \uc77c\uad00\uc131\uc744 \ubcf4\uc7a5\ud558\uc9c0\ub294 \uc54a\ub294\ub2e4. \uc815\ub82c \ud0a4\uac00 \ubcc0\uacbd\ub420 \uc218 \uc788\ub294\uc9c0, \ub370\uc774\ud130\uac00 \uc0ad\uc81c\ub418\ub294\uc9c0, \uc870\ud68c \uacb0\uacfc\ub97c \ud2b9\uc815 \uc2dc\uc810\uc73c\ub85c \uace0\uc815\ud574\uc57c \ud558\ub294\uc9c0\uc5d0 \ub530\ub77c \ucd94\uac00 \uc124\uacc4\uac00 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc815\ub82c \ud30c\ub77c\ubbf8\ud130 \uac80\uc99d<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc815\ub82c \uc870\uac74\uc744 \uc9c0\uc815\ud558\ub3c4\ub85d \ud560 \ub54c\ub294 \ud5c8\uc6a9\ub41c \uceec\ub7fc\ub9cc \uc0ac\uc6a9\ud560 \uc218 \uc788\ub3c4\ub85d \uc81c\ud55c\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const allowedSortFields = &#91;\n  \"createdAt\",\n  \"nickname\",\n] as const;\n\ntype UserSortField =\n  (typeof allowedSortFields)&#91;number];\n\nfunction parseSortField(\n  value: string | undefined\n): UserSortField {\n  if (\n    value &amp;&amp;\n    allowedSortFields.includes(\n      value as UserSortField\n    )\n  ) {\n    return value as UserSortField;\n  }\n\n  return \"createdAt\";\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">SQL\uc758 \uceec\ub7fc\uba85\uc740 \uc77c\ubc18\uc801\uc778 \uac12 \ubc14\uc778\ub529\ub9cc\uc73c\ub85c \ucc98\ub9ac\ud560 \uc218 \uc5c6\ub294 \uacbd\uc6b0\uac00 \ub9ce\ub2e4. \ub530\ub77c\uc11c \uc0ac\uc6a9\uc790 \uc785\ub825\uc744 SQL \ubb38\uc790\uc5f4\uc5d0 \uc9c1\uc811 \uc0bd\uc785\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc81c \ucffc\ub9ac\ub97c \uc0dd\uc131\ud560 \ub54c\ub294 \uac80\uc99d\ub41c \uceec\ub7fc\uba85\uc744 \uc0ac\uc804\uc5d0 \uc815\uc758\ub41c SQL \ud45c\ud604\uc2dd\uacfc \uc5f0\uacb0\ud558\uace0, \uac80\uc0c9\uac12\uc774\ub098 \ud398\uc774\uc9c0 \ud06c\uae30 \ub4f1\uc740 \ud30c\ub77c\ubbf8\ud130 \ubc14\uc778\ub529\uc744 \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud398\uc774\uc9c0\ub124\uc774\uc158\uc5d0\uc11c\ub294 \ucd5c\ub300 <code>limit<\/code>\ub3c4 \uc9c0\uc815\ud558\ub294 \uac83\uc774 \uc88b\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \uae30\ubcf8\uac12\uc744 20, \ucd5c\ub300\uac12\uc744 100\uc73c\ub85c \uc124\uc815\ud558\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uacfc\ub3c4\ud55c \ub370\uc774\ud130 \uc870\ud68c\ub97c \uc694\uccad\ud558\ub294 \uc0c1\ud669\uc744 \uc81c\ud55c\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">API \ubc84\uc800\ub2dd\uacfc \ud558\uc704 \ud638\ud658\uc131<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">API\ub294 \ud55c \ubc88 \ubc30\ud3ec\ud55c \ub4a4\uc5d0\ub3c4 \uacc4\uc18d \ubcc0\uacbd\ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc751\ub2f5 \ud544\ub4dc\uac00 \ucd94\uac00\ub418\uac70\ub098 \ub370\uc774\ud130 \uad6c\uc870\uac00 \ubcc0\uacbd\ub420 \uc218 \uc788\uace0, \uae30\uc874 \uae30\ub2a5\uc774 \uc0c8\ub85c\uc6b4 \ubc29\uc2dd\uc73c\ub85c \ub300\uccb4\ub420 \uc218\ub3c4 \uc788\ub2e4. \ud558\uc9c0\ub9cc \uc774\ubbf8 \ubc30\ud3ec\ub41c \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \uc989\uc2dc \uc5c5\ub370\uc774\ud2b8\ub418\uc9c0 \uc54a\uc744 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c API\ub97c \ubcc0\uacbd\ud560 \ub54c\ub294 \uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc815\uc0c1\uc801\uc73c\ub85c \ub3d9\uc791\ud558\ub294\uc9c0 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">URL \uae30\ubc18 \ubc84\uc800\ub2dd<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac00\uc7a5 \uc9c1\uad00\uc801\uc778 \ubc29\ubc95\uc740 URL\uc5d0 \ubc84\uc804\uc744 \ud3ec\ud568\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/api\/v1\/users\/123\nGET \/api\/v2\/users\/123<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 v1 \uc751\ub2f5\uc774 \ub2e4\uc74c\uacfc \uac19\ub2e4\uace0 \uac00\uc815\ud558\uc790.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"id\": 123,\n  \"nickname\": \"Player01\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">v2\uc5d0\uc11c\ub294 \ub2c9\ub124\uc784\uacfc \ud45c\uc2dc \uc774\ub984\uc744 \ubd84\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"id\": 123,\n  \"nickname\": \"player01\",\n  \"displayName\": \"Player01\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 <code>nickname<\/code>\uc744 \ud45c\uc2dc\uc6a9 \uc774\ub984\uc73c\ub85c \uc0ac\uc6a9\ud558\uace0 \uc788\uc5c8\ub2e4\uba74 \ud544\ub4dc\uc758 \uc758\ubbf8\ub97c \ubcc0\uacbd\ud558\ub294 \uac83\uc740 \ud638\ud658\uc131\uc744 \uae68\ub728\ub9b4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub54c v1 \uacc4\uc57d\uc740 \uc720\uc9c0\ud558\uace0 v2\uc5d0\uc11c \uc0c8\ub85c\uc6b4 \uc758\ubbf8\ub97c \uc81c\uacf5\ud558\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc774\uc804 \ubc84\uc804\uc5d0\uc11c \uc0c8 \ubc84\uc804\uc73c\ub85c \uc810\uc9c4\uc801\uc73c\ub85c \uc804\ud658\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc5b4\ub5a4 \ubcc0\uacbd\uc774 \ud558\uc704 \ud638\ud658\uc801\uc778\uac00?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud558\uc704 \ud638\ud658\uc131\uc740 \uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc0c8\ub85c\uc6b4 \uc11c\ubc84\uc640 \uacc4\uc18d \uc815\uc0c1\uc801\uc73c\ub85c \ud1b5\uc2e0\ud560 \uc218 \uc788\ub294\uc9c0\ub97c \uae30\uc900\uc73c\ub85c \ud310\ub2e8\ud55c\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\ubcc0\uacbd<\/th><th>\uc77c\ubc18\uc801\uc778 \uc601\ud5a5<\/th><\/tr><tr><td>\uc751\ub2f5\uc5d0 \uc120\ud0dd\uc801 \ud544\ub4dc \ucd94\uac00<\/td><td>\uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc54c \uc218 \uc5c6\ub294 \ud544\ub4dc\ub97c \ubb34\uc2dc\ud55c\ub2e4\uba74 \ub300\uccb4\ub85c \ud638\ud658\uc801<\/td><\/tr><tr><td>\uae30\uc874 \uc751\ub2f5 \ud544\ub4dc \uc0ad\uc81c<\/td><td>\ud638\ud658\uc131\uc744 \uae68\ub728\ub9b4 \uc218 \uc788\uc74c<\/td><\/tr><tr><td>\ud544\ub4dc \ud0c0\uc785 \ubcc0\uacbd<\/td><td>\ud638\ud658\uc131\uc744 \uae68\ub728\ub9b4 \uc218 \uc788\uc74c<\/td><\/tr><tr><td>\ud544\uc218 \uc694\uccad \ud544\ub4dc \ucd94\uac00<\/td><td>\uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \uc694\uccad\uc774 \uac70\ubd80\ub420 \uc218 \uc788\uc74c<\/td><\/tr><tr><td>\uae30\uc874 \ud544\ub4dc\uc758 \uc758\ubbf8 \ubcc0\uacbd<\/td><td>\ub3d9\uc791 \uc624\ub958\ub97c \uc77c\uc73c\ud0ac \uc218 \uc788\uc74c<\/td><\/tr><tr><td>\uae30\uc874 \uc0c1\ud0dc \ucf54\ub4dc\ub098 \uc624\ub958 \ucf54\ub4dc\uc758 \uc758\ubbf8 \ubcc0\uacbd<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8 \ubd84\uae30 \ub85c\uc9c1\uc5d0 \uc601\ud5a5\uc744 \uc904 \uc218 \uc788\uc74c<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\uc751\ub2f5 \ud544\ub4dc \ucd94\uac00\ub3c4 \ubaa8\ub4e0 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \uc548\uc804\ud55c \uac83\uc740 \uc544\ub2c8\ub2e4. \uc5c4\uaca9\ud55c \uc2a4\ud0a4\ub9c8 \uac80\uc99d\uc744 \uc0ac\uc6a9\ud558\uac70\ub098 \ud544\ub4dc \ubaa9\ub85d\uc774 \uc815\ud655\ud788 \uc77c\uce58\ud574\uc57c \ud558\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\ub77c\uba74 \ud544\ub4dc \ucd94\uac00\ub3c4 \ubb38\uc81c\uac00 \ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c API \uacc4\uc57d\uc744 \ubcc0\uacbd\ud560 \ub54c\ub294 \uc2e4\uc81c \ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \ucc98\ub9ac \ubc29\uc2dd\uc744 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Express \ub77c\uc6b0\ud130\uc5d0\uc11c \ubc84\uc804\uc744 \ubd84\ub9ac\ud55c\ub2e4<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>import { Router } from \"express\";\n\nconst apiRouter = Router();\n\nconst v1Router = Router();\nconst v2Router = Router();\n\nv1Router.get(\"\/users\/:id\", getUserV1);\nv2Router.get(\"\/users\/:id\", getUserV2);\n\napiRouter.use(\"\/v1\", v1Router);\napiRouter.use(\"\/v2\", v2Router);\n\napp.use(\"\/api\", apiRouter);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\uc5d0\uc11c\ub294 \ub2e4\uc74c \ub450 API\uac00 \ub3c5\ub9bd\uc801\uc73c\ub85c \uad00\ub9ac\ub41c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/api\/v1\/users\/123\nGET \/api\/v2\/users\/123<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub0b4\ubd80 \uc11c\ube44\uc2a4\ub098 \ub3c4\uba54\uc778 \ub85c\uc9c1\uc740 \uac00\ub2a5\ud55c \ud55c \uacf5\uc720\ud558\uace0, \ubc84\uc804\ubcc4 \ucee8\ud2b8\ub864\ub7ec \ub610\ub294 DTO\uc5d0\uc11c \uc678\ubd80 \uacc4\uc57d\uc744 \ubd84\ub9ac\ud558\ub294 \ubc29\uc2dd\uc774 \ud6a8\uc728\uc801\uc774\ub2e4. \ubc84\uc804\uc774 \ub298\uc5b4\ub0a0 \ub54c\ub9c8\ub2e4 \ubaa8\ub4e0 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \ubcf5\uc81c\ud558\uba74 \uc720\uc9c0\ubcf4\uc218 \ube44\uc6a9\uc774 \ucee4\uc9c4\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ubc84\uc804 \ud3d0\uae30 \uc815\ucc45<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0c8 \ubc84\uc804\uc774 \ucd9c\uc2dc\ub418\uc5c8\ub2e4\uace0 \ud574\uc11c \uae30\uc874 \ubc84\uc804\uc744 \uc989\uc2dc \uc81c\uac70\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc77c\ubc18\uc801\uc778 \uc804\ud658 \uc808\ucc28\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc0c8 API \ubc84\uc804 \ucd9c\uc2dc<\/li>\n\n\n\n<li>\uae30\uc874 \ubc84\uc804 \uc0ac\uc6a9\uc790\uc5d0\uac8c \ubcc0\uacbd \uc0ac\ud56d \uc548\ub0b4<\/li>\n\n\n\n<li>\ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \uc0c8 \ubc84\uc804 \uc804\ud658 \uc720\ub3c4<\/li>\n\n\n\n<li>\uae30\uc874 \ubc84\uc804\uc758 \uc0ac\uc6a9\ub7c9\uacfc \uc624\ub958\uc728 \ubaa8\ub2c8\ud130\ub9c1<\/li>\n\n\n\n<li>\uc815\ud574\uc9c4 \ud3d0\uae30 \uc77c\uc815\uc5d0 \ub530\ub77c \uae30\uc874 \ubc84\uc804 \uc885\ub8cc<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">API \ubc84\uc800\ub2dd\uc740 \ub2e8\uc21c\ud788 URL\uc5d0 \uc22b\uc790\ub97c \ubd99\uc774\ub294 \uc791\uc5c5\uc774 \uc544\ub2c8\ub2e4. <strong>API \uacc4\uc57d\uc744 \ubcc0\uacbd\ud558\uace0, \uc5ec\ub7ec \ud074\ub77c\uc774\uc5b8\ud2b8 \ubc84\uc804\uc744 \uc77c\uc815 \uae30\uac04 \ud568\uaed8 \uc9c0\uc6d0\ud558\uae30 \uc704\ud55c \uc6b4\uc601 \uc804\ub7b5<\/strong>\uc774\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">REST API \uc124\uacc4 \uc2dc \ucd94\uac00\ub85c \uace0\ub824\ud560 \uc0ac\ud56d<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\uc9c0\uae08\uae4c\uc9c0 \uc0b4\ud3b4\ubcf8 \uc6d0\uce59 \uc678\uc5d0\ub3c4 \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ub2e4\uc74c \uc0ac\ud56d\uc744 \ud568\uaed8 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc778\uc99d\uacfc \uc778\uac00<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc778\uc99d(Authentication)\uc740 \uc0ac\uc6a9\uc790\uac00 \ub204\uad6c\uc778\uc9c0 \ud655\uc778\ud558\ub294 \uacfc\uc815\uc774\uace0, \uc778\uac00(Authorization)\ub294 \ud574\ub2f9 \uc0ac\uc6a9\uc790\uac00 \ud2b9\uc815 \ub9ac\uc18c\uc2a4\uc5d0 \uc811\uadfc\ud560 \uc218 \uc788\ub294\uc9c0 \ud655\uc778\ud558\ub294 \uacfc\uc815\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\uc778\ud55c \uc0ac\uc6a9\uc790\ub77c\uace0 \ud574\uc11c \ub2e4\ub978 \uc0ac\uc6a9\uc790\uc758 \uc815\ubcf4\ub97c \uc218\uc815\ud560 \uc218 \uc788\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>PATCH \/users\/123\nAuthorization: Bearer &lt;access-token&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\ub294 \ud1a0\ud070\uc758 \uc720\ud6a8\uc131\ubfd0 \uc544\ub2c8\ub77c \uc694\uccad\ud55c \uc0ac\uc6a9\uc790\uac00 \ud574\ub2f9 \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \uc218\uc815\ud560 \uad8c\ud55c\uc774 \uc788\ub294\uc9c0\ub3c4 \ud655\uc778\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud2b9\ud788 URL\uc5d0 \ud3ec\ud568\ub41c \uc0ac\uc6a9\uc790 ID\ub9cc\uc73c\ub85c \uad8c\ud55c\uc744 \ud310\ub2e8\ud558\uba74 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Rate Limiting<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud2b9\uc815 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc9e7\uc740 \uc2dc\uac04\uc5d0 \uc9c0\ub098\uce58\uac8c \ub9ce\uc740 \uc694\uccad\uc744 \ubcf4\ub0b4\ub294 \uac83\uc744 \uc81c\ud55c\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 429 Too Many Requests\nRetry-After: 10<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\uc778, \uc778\uc99d \ucf54\ub4dc \ubc1c\uae09, \uac80\uc0c9 API \ub4f1\uc740 \uc545\uc6a9 \uac00\ub2a5\uc131\uacfc \uc11c\ubc84 \ubd80\ud558\ub97c \uace0\ub824\ud574 \uc801\uc808\ud55c \uc81c\ud55c \uc815\ucc45\uc744 \uc801\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub85c\uae45\uacfc \ucd94\uc801<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">API \uc694\uccad\uc5d0\ub294 \uc694\uccad ID\ub97c \ubd80\uc5ec\ud558\uace0 \ub85c\uadf8\uc5d0 \ud568\uaed8 \uae30\ub85d\ud558\uba74 \uc7a5\uc560 \ubd84\uc11d\uc774 \uc26c\uc6cc\uc9c4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\uc5d0\ub294 \uc694\uccad \uacbd\ub85c, \uc751\ub2f5 \uc0c1\ud0dc \ucf54\ub4dc, \ucc98\ub9ac \uc2dc\uac04, \uc624\ub958 \ucf54\ub4dc \ub4f1\uc744 \uae30\ub85d\ud560 \uc218 \uc788\ub2e4. \ub2e8, \ube44\ubc00\ubc88\ud638, \uc561\uc138\uc2a4 \ud1a0\ud070, \ubbfc\uac10\ud55c \uac1c\uc778\uc815\ubcf4\ub294 \uadf8\ub300\ub85c \uae30\ub85d\ud558\uc9c0 \uc54a\uc544\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">API \ubb38\uc11c\ud654<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Swagger UI\uc640 OpenAPI\ub97c \uc0ac\uc6a9\ud558\uba74 API\uc758 \uacbd\ub85c, \uba54\uc11c\ub4dc, \uc694\uccad DTO, \uc751\ub2f5 DTO, \uc0c1\ud0dc \ucf54\ub4dc, \uc778\uc99d \ubc29\uc2dd \ub4f1\uc744 \uba85\uc2dc\uc801\uc73c\ub85c \uad00\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">API \uacc4\uc57d\uc744 \ucf54\ub4dc\uc640 \ud568\uaed8 \uad00\ub9ac\ud558\uba74 \ud504\ub860\ud2b8\uc5d4\ub4dc\uc640 \ubc31\uc5d4\ub4dc \uc0ac\uc774\uc758 \ubd88\uc77c\uce58\ub97c \uc904\uc774\uace0 \ud14c\uc2a4\ud2b8 \uc790\ub3d9\ud654\uc5d0\ub3c4 \ud65c\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>REST API\ub780? REST(Representational State Transfer)\ub294 \ub124\ud2b8\uc6cc\ud06c\ub97c \ud1b5\ud574 \ub9ac\uc18c\uc2a4\ub97c \ub2e4\ub8e8\uae30 \uc704\ud55c \uc544\ud0a4\ud14d\ucc98 \uc2a4\ud0c0\uc77c\uc774\ub2e4. REST API\ub294 \uc774\ub7ec\ud55c \uc6d0\uce59\uc744 HTTP \ud504\ub85c\ud1a0\ucf5c\uc5d0 \uc801\uc6a9\ud574 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84\uac00 \ub370\uc774\ud130\ub97c \uc8fc\uace0\ubc1b\ub3c4\ub85d \uc124\uacc4\ud55c \uc778\ud130\ud398\uc774\uc2a4\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c \uc720\uc800 \uc815\ubcf4, \uc778\ubca4\ud1a0\ub9ac, \uac8c\uc784 \uae30\ub85d\uc744 \uad00\ub9ac\ud55c\ub2e4\uace0 \uac00\uc815\ud558\uc790. \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 HTTP \uc694\uccad\uc744 \ud1b5\ud574 \uc720\uc800 \uc815\ubcf4\ub97c \uc870\ud68c\ud558\uac70\ub098 \uc544\uc774\ud15c\uc744 \uc0ac\uc6a9\ud558\uace0 \uac8c\uc784 \uae30\ub85d\uc744 \ud655\uc778\ud560 \uc218 \uc788\ub2e4. REST API\ub97c \uc124\uacc4\ud560 \ub54c \uc911\uc694\ud55c [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2654","post","type-post","status-publish","format-standard","hentry","category-dev-logs"],"_links":{"self":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2654","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2654"}],"version-history":[{"count":1,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2654\/revisions"}],"predecessor-version":[{"id":2655,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2654\/revisions\/2655"}],"wp:attachment":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2654"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2654"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2654"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}