\ud604\ub300 \uc6f9 \uac1c\ubc1c\uc5d0\uc11c RESTful API<\/strong>\ub294 \uc11c\ubc84\uc640 \ud074\ub77c\uc774\uc5b8\ud2b8 \uac04\uc758 \uc6d0\ud65c\ud55c \ub370\uc774\ud130 \uc804\uc1a1 \ubc0f \uc0c1\ud638\uc791\uc6a9\uc744 \uc704\ud574 \ud544\uc218\uc801\uc778 \uac1c\ub150\uc785\ub2c8\ub2e4. Express.js\ub294 Node.js \ud658\uacbd\uc5d0\uc11c RESTful API\ub97c \uad6c\ucd95\ud558\uae30 \uc704\ud55c \uac04\ud3b8\ud558\uace0 \uac15\ub825\ud55c \ud504\ub808\uc784\uc6cc\ud06c\ub85c \uc790\ub9ac\uc7a1\uc558\uc2b5\ub2c8\ub2e4. \uc774\ubc88 \uae00\uc5d0\uc11c\ub294 RESTful API\uc758 \uac1c\ub150, \uc124\uacc4 \uc6d0\uce59, \uadf8\ub9ac\uace0 Express\ub97c \uc0ac\uc6a9\ud55c \uc608\uc81c \ucf54\ub4dc\ub97c \ud1b5\ud574 \uc774\ub97c \uc774\ud574\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4.<\/p>\n REST(Representational State Transfer)\ub294 \uc6f9 \uc544\ud0a4\ud14d\ucc98 \uc2a4\ud0c0\uc77c \uc911 \ud558\ub098\ub85c, HTTP \ud504\ub85c\ud1a0\ucf5c\uc744 \uae30\ubc18\uc73c\ub85c \ud569\ub2c8\ub2e4. RESTful API\ub294 \uc774\ub7ec\ud55c REST\uc758 \uc6d0\uce59\uc744 \uc900\uc218\ud558\uc5ec \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84\uac00 \ud1b5\uc2e0\ud558\ub294 \ubc29\uc2dd\uc785\ub2c8\ub2e4. RESTful API\ub97c \uc0ac\uc6a9\ud558\uba74 \ub2e4\uc591\ud55c \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc11c\ubc84\uc758 \uc790\uc6d0\uc5d0 \uc811\uadfc\ud558\uace0 \uc0c1\ud638\uc791\uc6a9\ud560 \uc218 \uc788\uc73c\uba70, \uc774 \uc790\uc6d0\uc740 URI(Uniform Resource Identifier)\ub97c \ud1b5\ud574 \uc2dd\ubcc4\ub429\ub2c8\ub2e4.<\/p>\n RESTful API\ub97c \uc124\uacc4\ud560 \ub54c \uc900\uc218\ud574\uc57c \ud560 \uba87 \uac00\uc9c0 \uc6d0\uce59\uc774 \uc788\uc2b5\ub2c8\ub2e4. \uc774\ub294 API\uc758 \uc77c\uad00\uc131\uacfc \uc0ac\uc6a9\uc131\uc744 \ubcf4\uc7a5\ud558\ub294 \ub370 \ub3c4\uc6c0\uc774 \ub429\ub2c8\ub2e4.<\/p>\n RESTful API\ub294 \uc790\uc6d0 \uc911\uc2ec\uc73c\ub85c \uc124\uacc4\ub418\uc5b4\uc57c \ud558\uba70, \uac01 \uc790\uc6d0\uc740 \uace0\uc720\ud55c URI\ub85c \uc2dd\ubcc4\ub429\ub2c8\ub2e4. URI\ub294 \uc758\ubbf8\ub860\uc801\uc73c\ub85c \uc774\ud574\ud560 \uc218 \uc788\uc5b4\uc57c \ud558\uba70, \ub2e4\uc74c\uacfc \uac19\uc740 \uaddc\uce59\uc744 \ub530\ub985\ub2c8\ub2e4:<\/p>\n \uc790\uc6d0\uc5d0 \ub300\ud55c \uc791\uc5c5\uc740 \ub2e4\uc74c\uc758 HTTP \uba54\uc18c\ub4dc\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc218\ud589\ud569\ub2c8\ub2e4:<\/p>\n HTTP \uc0c1\ud0dc \ucf54\ub4dc\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \uc694\uccad \ucc98\ub9ac \uacb0\uacfc\ub97c \uc804\ub2ec\ud558\ub294 \ub370 \ud544\uc694\ud569\ub2c8\ub2e4. \ub2e4\uc74c\uc740 \uc790\uc8fc \uc0ac\uc6a9\ub418\ub294 \uc0c1\ud0dc \ucf54\ub4dc\uc785\ub2c8\ub2e4:<\/p>\n API\uac00 \uc9c4\ud654\ud568\uc5d0 \ub530\ub77c \uae30\uc874\uc758 API\uc640 \ud638\ud658\ub418\uc9c0 \uc54a\ub294 \ubcc0\uacbd\uc774 \uc788\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ub530\ub77c\uc11c API \ubc84\uc804\uc744 \uba85\uc2dc\ud558\uc5ec \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ud2b9\uc815 \ubc84\uc804\uc744 \uc0ac\uc6a9\ud558\ub3c4\ub85d \ud569\ub2c8\ub2e4. \uc77c\ubc18\uc801\uc73c\ub85c URL\uc5d0 \ubc84\uc804 \ubc88\ud638\ub97c \ud3ec\ud568\uc2dc\ud0b5\ub2c8\ub2e4:<\/p>\n \uc774\uc81c Express.js\ub97c \uc0ac\uc6a9\ud558\uc5ec \uac04\ub2e8\ud55c RESTful API\ub97c \uad6c\ucd95\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4. \uc774 \uc608\uc81c\uc5d0\uc11c\ub294 \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \uad00\ub9ac\ud558\ub294 API\ub97c \uad6c\ud604\ud569\ub2c8\ub2e4.<\/p>\n \uba3c\uc800, Express \ud504\ub85c\uc81d\ud2b8\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4. Node.js\uac00 \uc124\uce58\ub418\uc5b4 \uc788\uc5b4\uc57c \ud558\uba70, \uc0c8\ub85c\uc6b4 \ud504\ub85c\uc81d\ud2b8\ub97c \ub9cc\ub4e4\uace0 \ud544\uc694\ud55c \ud328\ud0a4\uc9c0\ub97c \uc124\uce58\ud569\ub2c8\ub2e4:<\/p>\n \uc544\ub798\uc758 \ucf54\ub4dc\ub85c \uc774\uc81c \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \uad00\ub9ac\ud558\uae30 \uc704\ud55c CRUD \uc5d4\ub4dc\ud3ec\uc778\ud2b8\ub97c \ucd94\uac00\ud574 \ubcf4\uaca0\uc2b5\ub2c8\ub2e4.<\/p>\n \uc11c\ubc84\ub97c \uc2e4\ud589\ud569\ub2c8\ub2e4:<\/p>\n \ube0c\ub77c\uc6b0\uc800\ub098 Postman\uacfc \uac19\uc740 API \ud074\ub77c\uc774\uc5b8\ud2b8\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc5d4\ub4dc\ud3ec\uc778\ud2b8\ub97c \ud14c\uc2a4\ud2b8\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n RESTful API\ub97c \uac1c\ubc1c\ud55c \ud6c4\uc5d0\ub294 \ubb38\uc11c\ud654\uac00 \ud544\uc694\ud569\ub2c8\ub2e4. \ubb38\uc11c\ud654\ub294 API \uc0ac\uc6a9\uc790\uac00 API\ub97c \uc27d\uac8c \uc774\ud574\ud558\uace0 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub3c4\ub85d \ub3c4\uc640\uc90d\ub2c8\ub2e4. Swagger, Postman\uacfc \uac19\uc740 \ub3c4\uad6c\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc27d\uac8c \ubb38\uc11c\ud654\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. Swagger UI\ub97c \uc0ac\uc6a9\ud558\uba74 API \ubb38\uc11c\ub97c \uc2dc\uac01\uc801\uc73c\ub85c \uc791\uc131\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n \uc774\ubc88 \uae00\uc5d0\uc11c\ub294 Express.js\ub97c \uc0ac\uc6a9\ud55c RESTful API\uc758 \uac1c\ub150\uacfc \uc124\uacc4 \uc6d0\uce59\uc744 \uc0b4\ud3b4\ubcf4\uc558\uc2b5\ub2c8\ub2e4. RESTful API\ub294 \uc6f9 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc758 \ud544\uc218\uc801\uc778 \ubd80\ubd84\uc774\uba70, Express.js\ub97c \uc0ac\uc6a9\ud558\uc5ec \uac04\ub2e8\ud558\uace0 \ud6a8\uc728\uc801\uc73c\ub85c \uad6c\ucd95\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc124\uacc4 \uc6d0\uce59\uc744 \uc9c0\ud0b4\uc73c\ub85c\uc368 \uc0ac\uc6a9\uc790\ub294 API\ub97c \ub354\uc6b1 \uc27d\uac8c \ud65c\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc774\ub7ec\ud55c \uc6d0\uce59\uc744 \ubc14\ud0d5\uc73c\ub85c \uc5ec\ub7ec\ubd84\uc758 \ud504\ub85c\uc81d\ud2b8\uc5d0 \uc801\ud569\ud55c RESTful API\ub97c \uad6c\ucd95\ud574 \ubcf4\uc2dc\uae30 \ubc14\ub78d\ub2c8\ub2e4.<\/p>\n1. RESTful API\ub780?<\/h2>\n
1.1. REST\uc758 \uc8fc\uc694 \ud2b9\uc9d5<\/h3>\n
\n
2. RESTful API\uc758 \uc124\uacc4 \uc6d0\uce59<\/h2>\n
2.1. \uc790\uc6d0(URL)\uc758 \uc124\uacc4<\/h3>\n
\n
\/users<\/code>\ub85c \ud45c\ud604\ud569\ub2c8\ub2e4.<\/li>\n\/users\/:userId\/posts<\/code>\ub85c \ud45c\ud604\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/li>\n<\/ul>\n2.2. HTTP \uba54\uc18c\ub4dc\uc758 \ud65c\uc6a9<\/h3>\n
\n
GET \/users<\/code>)<\/li>\nPOST \/users<\/code>)<\/li>\nPUT \/users\/:userId<\/code>)<\/li>\nPATCH \/users\/:userId<\/code>)<\/li>\nDELETE \/users\/:userId<\/code>)<\/li>\n<\/ul>\n2.3. \uc0c1\ud0dc \ucf54\ub4dc\uc758 \ud65c\uc6a9<\/h3>\n
\n
200 OK<\/code>: \uc131\uacf5\uc801\uc778 \uc694\uccad<\/li>\n201 Created<\/code>: \uc790\uc6d0 \uc0dd\uc131 \uc131\uacf5<\/li>\n204 No Content<\/code>: \uc694\uccad \uc131\uacf5, \ubc18\ud658\ud560 \ub370\uc774\ud130 \uc5c6\uc74c<\/li>\n400 Bad Request<\/code>: \uc798\ubabb\ub41c \uc694\uccad<\/li>\n404 Not Found<\/code>: \uc790\uc6d0 \uc5c6\uc74c<\/li>\n500 Internal Server Error<\/code>: \uc11c\ubc84 \uc5d0\ub7ec<\/li>\n<\/ul>\n2.4. \ubc84\uc804 \uad00\ub9ac<\/h3>\n
\/v1\/users<\/code><\/pre>\n3. Express.js\ub97c \uc774\uc6a9\ud55c RESTful API \uad6c\ucd95<\/h2>\n
3.1. Express \ud504\ub85c\uc81d\ud2b8 \uc124\uc815<\/h3>\n
mkdir express-api-example\ncd express-api-example\nnpm init -y\nnpm install express body-parser<\/code><\/pre>\n3.2. \uae30\ubcf8 \uc11c\ubc84 \uc124\uc815<\/h3>\n
server.js<\/code> \ud30c\uc77c\uc744 \uc0dd\uc131\ud558\uace0 \uae30\ubcf8 Express \uc11c\ubc84\ub97c \uc124\uc815\ud569\ub2c8\ub2e4:<\/p>\nconst express = require('express');\nconst bodyParser = require('body-parser');\n\nconst app = express();\nconst PORT = 3000;\n\n\/\/ Middleware\napp.use(bodyParser.json());\n\n\/\/ \uae30\ubcf8 \ub77c\uc6b0\ud130\napp.get('\/', (req, res) => {\n res.send('Welcome to the Express RESTful API!');\n});\n\n\/\/ \uc11c\ubc84 \uc2e4\ud589\napp.listen(PORT, () => {\n console.log(`Server is running on http:\/\/localhost:${PORT}`);\n});<\/code><\/pre>\n3.3. RESTful API \uc5d4\ub4dc\ud3ec\uc778\ud2b8 \uc0dd\uc131<\/h3>\n
\n\/\/ \uac00\uc0c1\uc758 \uc0ac\uc6a9\uc790 \ub370\uc774\ud130\ub97c \uc800\uc7a5\ud558\uae30 \uc704\ud55c \ubc30\uc5f4\nlet users = [];\n\n\/\/ GET: \uc0ac\uc6a9\uc790 \ubaa9\ub85d \uc870\ud68c\napp.get('\/users', (req, res) => {\n res.json(users);\n});\n\n\/\/ GET: \ud2b9\uc815 \uc0ac\uc6a9\uc790 \uc870\ud68c\napp.get('\/users\/:userId', (req, res) => {\n const user = users.find(u => u.id === parseInt(req.params.userId));\n if (!user) return res.status(404).send('User not found');\n res.json(user);\n});\n\n\/\/ POST: \uc0ac\uc6a9\uc790 \ucd94\uac00\napp.post('\/users', (req, res) => {\n const user = {\n id: users.length + 1,\n name: req.body.name,\n email: req.body.email\n };\n users.push(user);\n res.status(201).json(user);\n});\n\n\/\/ PUT: \uc0ac\uc6a9\uc790 \uc815\ubcf4 \uc218\uc815\napp.put('\/users\/:userId', (req, res) => {\n let user = users.find(u => u.id === parseInt(req.params.userId));\n if (!user) return res.status(404).send('User not found');\n \n user.name = req.body.name;\n user.email = req.body.email;\n res.json(user);\n});\n\n\/\/ DELETE: \uc0ac\uc6a9\uc790 \uc0ad\uc81c\napp.delete('\/users\/:userId', (req, res) => {\n users = users.filter(u => u.id !== parseInt(req.params.userId));\n res.status(204).send();\n});<\/code><\/pre>\n3.4. \uc11c\ubc84 \uc2e4\ud589 \ubc0f \ud14c\uc2a4\ud2b8<\/h3>\n
node server.js<\/code><\/pre>\n4. API \ubb38\uc11c\ud654<\/h2>\n
5. \uacb0\ub860<\/h2>\n
6. \ucc38\uace0 \uc790\ub8cc<\/h2>\n