{"id":938,"date":"2026-05-26T23:13:14","date_gmt":"2026-05-26T15:13:14","guid":{"rendered":"https:\/\/junai.ai\/blog\/fastapi-pydantic-request-response-3\/"},"modified":"2026-05-26T23:13:14","modified_gmt":"2026-05-26T15:13:14","slug":"fastapi-pydantic-request-response-3","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/fastapi-pydantic-request-response-3\/","title":{"rendered":"FastAPI Pydantic \u2014 \uc694\uccad \ubcf8\ubb38\uacfc \uc751\ub2f5 \ubaa8\ub378"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 925 -->\n<div style=\"max-width:800px;margin:0 auto;\">\n<style>\n:root {--color-primary:#00897b;--color-accent:#009688;--color-bg:#fafbfc;--color-bg-card:#fff;--color-text:#1a202c;--color-text-muted:#64748b;--hero-start:#004d40;--hero-end:#00897b;}\n*{box-sizing:border-box;}\n.container{max-width:760px;margin:0 auto;padding:0 24px 80px;}\n.hero{background:linear-gradient(135deg,var(--hero-start) 0%,var(--hero-end) 100%);color:#fff;padding:80px 24px 60px;text-align:center;}\n.hero .eyebrow{display:inline-block;font-size:14px;color:#80cbc4;font-weight:700;letter-spacing:0.1em;text-transform:uppercase;margin-bottom:14px;}\n.hero h1{font-size:36px;margin:0 0 16px;line-height:1.3;font-weight:800;}\n.hero p{color:#b2dfdb;font-size:18px;max-width:640px;margin:0 auto;line-height:1.6;}\n.hero img{width:100%;max-width:640px;height:auto;margin:32px auto 0;border-radius:10px;display:block;}\narticle{padding-top:48px;}\narticle h2{font-size:26px;margin:56px 0 20px;padding-left:14px;border-left:5px solid var(--color-accent);line-height:1.4;}\narticle h3{font-size:19px;margin:32px 0 12px;color:var(--color-primary);}\narticle p{margin:16px 0;}\narticle strong{color:var(--color-primary);font-weight:700;}\narticle code{background:#b2dfdb;padding:2px 8px;border-radius:4px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;color:#004d40;}\n.databox{background:#b2dfdb;border-left:4px solid var(--color-accent);padding:16px 20px;margin:24px 0;border-radius:0 8px 8px 0;font-size:15.5px;}\n.databox strong{color:var(--color-primary);}\n.warnbox{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);padding:16px 20px;margin:24px 0;border-radius:8px;font-size:15.5px;}\n.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch;margin:22px 0;}\ntable{width:100%;border-collapse:collapse;font-size:15px;background:var(--color-bg-card);}\nth,td{padding:11px 12px;text-align:left;border-bottom:1px solid #e2e8f0;vertical-align:top;}\nth{background:#f1f5f9;font-weight:700;color:#0f172a;}\ntd:first-child,th:first-child{font-weight:700;}\n@media (max-width:560px){.tablewrap table,.tablewrap thead,.tablewrap tbody,.tablewrap tr,.tablewrap th,.tablewrap td{display:block;width:auto;}.tablewrap thead{display:none;}.tablewrap tr{margin:0 0 14px;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden;}.tablewrap td{border:none;border-bottom:1px solid #f1f5f9;padding:9px 14px;}.tablewrap td:first-child{background:#f1f5f9;font-weight:800;font-size:15.5px;}.tablewrap td:last-child{border-bottom:none;}.tablewrap td[data-label]::before{content:attr(data-label) \" \u2014 \";font-weight:700;color:var(--color-primary);}}\n.code-block{background:#0f172a;color:#e2e8f0;padding:16px 20px;border-radius:8px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;line-height:1.6;margin:20px 0;overflow-x:auto;white-space:pre;}\n.cta{background:linear-gradient(135deg,#00897b 0%,#009688 100%);color:#fff;padding:28px 24px;border-radius:12px;margin:48px 0 0;text-align:center;}\n.cta h3{color:#fff;margin:0 0 8px;font-size:20px;}\n.cta p{color:#b2dfdb;margin:0;font-size:15.5px;}\n.footer-nav{margin-top:32px;padding-top:20px;border-top:1px solid #e2e8f0;font-size:14px;color:var(--color-text-muted);}\n.footer-nav a{color:var(--color-primary);text-decoration:none;}\n@media (max-width:480px){.hero h1{font-size:26px;}.hero p{font-size:16px;}article h2{font-size:21px;}article h3{font-size:17px;}body{font-size:16px;}}\n<\/style>\n<section class=\"hero\">\n  <span class=\"eyebrow\">FastAPI \uad50\uc7ac \u00b7 3\ud3b8 \u00b7 \uc694\uccad \ubcf8\ubb38\uacfc \uc751\ub2f5<\/span>\n  <h1>FastAPI Pydantic \u2014 \uc694\uccad \ubcf8\ubb38\uacfc \uc751\ub2f5 \ubaa8\ub378<\/h1>\n  <p>\uc774\ub984\u00b7\uc774\uba54\uc77c\u00b7\ube44\ubc00\ubc88\ud638\ucc98\ub7fc \ubb36\uc778 \ub370\uc774\ud130\ub294 \uc8fc\uc18c\uc5d0 \ubabb \uc2e3\ub294\ub2e4. Pydantic \ubaa8\ub378 \ud558\ub098\ub85c \ubc1b\uace0, \uac80\uc99d\ud558\uace0, \uc751\ub2f5 \ubaa8\uc591\uae4c\uc9c0 \uace0\uc815\ud55c\ub2e4.<\/p>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-5-100.jpg\" alt=\"\ub4e4\uc5b4\uc624\ub294 JSON \uac1d\uccb4\uac00 \ud544\ud130\ub97c \ud1b5\uacfc\ud574 \ud30c\uc774\uc36c Pydantic \ubaa8\ub378 \uc0c1\uc790\ub85c \uac80\uc99d\ub418\uc5b4 \ub4e4\uc5b4\uac00\ub294 \ucee8\uc149 \uc544\uc774\uc18c\uba54\ud2b8\ub9ad \uc77c\ub7ec\uc2a4\ud2b8\">\n<\/section>\n\n<div class=\"container\">\n<article>\n\n<p>2\ud3b8\uc5d0\uc11c \uac12\uc744 \ubc1b\ub294 \ub450 \ud1b5\ub85c, \uacbd\ub85c\uc640 \ucffc\ub9ac\ub97c \uc775\ud614\ub2e4. \ub458 \ub2e4 <strong>\uc8fc\uc18c\uc5d0 \uc2e4\ub9ac\ub294 \ud55c\ub450 \uac1c\uc9dc\ub9ac \uac12<\/strong>\uc774\uc5c8\ub2e4. \uadf8\ub7f0\ub370 \ud68c\uc6d0\uac00\uc785\uc744 \ub5a0\uc62c\ub824 \ubcf4\uc790. \uc774\ub984, \uc774\uba54\uc77c, \ube44\ubc00\ubc88\ud638, \uc57d\uad00 \ub3d9\uc758 \uc5ec\ubd80\uac00 \ud55c\uaebc\ubc88\uc5d0 \ub118\uc5b4\uc628\ub2e4. \uc774\uac78 \uc8fc\uc18c\uc5d0 \ub2e4 \ubd99\uc774\uba74 <code>\/signup?name=...&email=...&password=...<\/code> \ucc98\ub7fc \ub054\ucc0d\ud574\uc9c0\uace0, \ube44\ubc00\ubc88\ud638\uac00 URL \uc5d0 \uadf8\ub300\ub85c \ubc15\ud600 \uc11c\ubc84 \ub85c\uadf8\uc5d0 \ub0a8\ub294\ub2e4.<\/p>\n\n<p>\uadf8\ub798\uc11c \ubb36\uc778 \ub370\uc774\ud130\ub294 \uc8fc\uc18c\uac00 \uc544\ub2c8\ub77c <strong>\uc694\uccad \ubcf8\ubb38(request body)<\/strong> \uc5d0 JSON \uc73c\ub85c \ub2f4\uc544 \ubcf4\ub0b8\ub2e4. 3\ud3b8\uc740 \uadf8 \ubcf8\ubb38\uc744 \ubc1b\ub294 \uc815\uc11d, <strong>Pydantic \ubaa8\ub378<\/strong>\uc744 \ub2e4\ub8ec\ub2e4. \ubaa8\ub378\ub85c \ubc1b\uc73c\uba74 \ub4e4\uc5b4\uc628 JSON \uc744 \uac80\uc99d\ud558\ub294 \uc77c\ub3c4, \uc751\ub2f5\uc5d0\uc11c \ube44\ubc00\ubc88\ud638\ub97c \ube7c\ub294 \uc77c\ub3c4 \uac70\uc758 \uacf5\uc9dc\ub85c \ub530\ub77c\uc628\ub2e4.<\/p>\n\n<h2>1. \uc8fc\uc18c\ub85c \ubabb \ubc1b\ub294 \uac83 \u2014 \ubb36\uc778 \ub370\uc774\ud130\ub294 \ubcf8\ubb38\uc5d0<\/h2>\n\n<p>\uacbd\ub85c\uc640 \ucffc\ub9ac\ub294 \uac12 \ud558\ub098\ud558\ub098\uac00 \uc8fc\uc18c \ubb38\uc790\uc5f4\uc5d0 \ub178\ucd9c\ub41c\ub2e4. \uc9e7\uace0 \ub2e8\uc21c\ud55c \uc2dd\ubcc4\uc790\ub098 \ud544\ud130\uc5d0\ub294 \ub354\uc5c6\uc774 \uc88b\uc9c0\ub9cc, \ud544\ub4dc\uac00 \ub300\uc5ec\uc12f \uac1c\ub85c \ub298\uace0 \uadf8\uc911\uc5d0 \ubbfc\uac10\ud55c \uac12\uc774 \uc11e\uc774\uba74 \ud55c\uacc4\uac00 \ubd84\uba85\ud558\ub2e4. URL \uae38\uc774 \uc81c\ud55c\uc5d0 \uac78\ub9ac\uace0, \uc911\ucca9\ub41c \uad6c\uc870(\uc8fc\uc18c \uc548\uc5d0 \ub3c4\uc2dc\u00b7\uc6b0\ud3b8\ubc88\ud638)\ub294 \uc544\uc608 \ud45c\ud604\uc774 \uc548 \ub418\uba70, \ub85c\uadf8\u00b7\ube0c\ub77c\uc6b0\uc800 \uae30\ub85d\uc5d0 \uac12\uc774 \uadf8\ub300\ub85c \ub0a8\ub294\ub2e4.<\/p>\n\n<p>HTTP \ub294 \uc774\ub7f0 \uacbd\uc6b0\ub97c \uc704\ud574 <strong>\ubcf8\ubb38<\/strong>\uc774\ub77c\ub294 \uc790\ub9ac\ub97c \ub530\ub85c \ub454\ub2e4. \ubcf4\ud1b5 <code>POST<\/code>\u00b7<code>PUT<\/code> \uc694\uccad\uacfc \ud568\uaed8 \ubcf4\ub0b4\uace0, \ud615\uc2dd\uc740 \ub300\uac1c JSON \uc774\ub2e4. \uc815\ub9ac\ud558\uba74 \uae30\uc900\uc740 \ub2e8\uc21c\ud558\ub2e4 \u2014 <strong>&#8220;\uac00\ub9ac\ud0a4\ub294 \uac12&#8221;\uc740 \uc8fc\uc18c\ub85c, &#8220;\ubcf4\ub0b4\ub294 \ub369\uc5b4\ub9ac&#8221;\ub294 \ubcf8\ubb38\uc73c\ub85c.<\/strong><\/p>\n\n<div class=\"tablewrap\">\n<table>\n<thead><tr><th>\uad6c\ubd84<\/th><th>\uacbd\ub85c\u00b7\ucffc\ub9ac \ub9e4\uac1c\ubcc0\uc218<\/th><th>\uc694\uccad \ubcf8\ubb38(Body)<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>\ub2f4\ub294 \uacf3<\/td><td data-label=\"\uacbd\ub85c\u00b7\ucffc\ub9ac\">URL \ubb38\uc790\uc5f4<\/td><td data-label=\"\ubcf8\ubb38\">\uc694\uccad \ubab8\uccb4 JSON<\/td><\/tr>\n<tr><td>\uc801\ud569\ud55c \ub370\uc774\ud130<\/td><td data-label=\"\uacbd\ub85c\u00b7\ucffc\ub9ac\">\uc2dd\ubcc4\uc790\u00b7\ud544\ud130 \ud55c\ub450 \uac1c<\/td><td data-label=\"\ubcf8\ubb38\">\ud544\ub4dc \uc5ec\ub7ec \uac1c \ubb36\uc74c<\/td><\/tr>\n<tr><td>\uc8fc \uba54\uc11c\ub4dc<\/td><td data-label=\"\uacbd\ub85c\u00b7\ucffc\ub9ac\">GET<\/td><td data-label=\"\ubcf8\ubb38\">POST \u00b7 PUT \u00b7 PATCH<\/td><\/tr>\n<tr><td>\uc911\ucca9 \uad6c\uc870<\/td><td data-label=\"\uacbd\ub85c\u00b7\ucffc\ub9ac\">\ud45c\ud604 \uc5b4\ub824\uc6c0<\/td><td data-label=\"\ubcf8\ubb38\">\uac1d\uccb4\u00b7\ubc30\uc5f4 \uc790\uc720<\/td><\/tr>\n<tr><td>\ubbfc\uac10 \uc815\ubcf4<\/td><td data-label=\"\uacbd\ub85c\u00b7\ucffc\ub9ac\">\ub85c\uadf8\uc5d0 \ub178\ucd9c<\/td><td data-label=\"\ubcf8\ubb38\">\uc0c1\ub300\uc801\uc73c\ub85c \uc548\uc804<\/td><\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<h2>2. Pydantic BaseModel \ub85c \uc694\uccad \ubc1b\uae30<\/h2>\n\n<p>\ubcf8\ubb38\uc744 \ubc1b\ub294 \ubc29\ubc95\uc740 \uc758\uc678\ub85c \uae54\ub054\ud558\ub2e4. \ubc1b\uace0 \uc2f6\uc740 \ub370\uc774\ud130\uc758 <strong>\ubaa8\uc591\uc744 \ud074\ub798\uc2a4\ub85c \ud55c \ubc88 \uc120\uc5b8<\/strong>\ud558\uace0, \uadf8 \ud074\ub798\uc2a4\ub97c \ud568\uc218 \uc778\uc790\uc758 \ud0c0\uc785\ud78c\ud2b8\ub85c \uc801\uae30\ub9cc \ud558\uba74 \ub41c\ub2e4. \uc774 \ud074\ub798\uc2a4\ub97c \ub9cc\ub4dc\ub294 \ub3c4\uad6c\uac00 1\ud3b8\uc5d0\uc11c \uc774\ub984\ub9cc \ub098\uc654\ub358 <strong>Pydantic<\/strong>\uc758 <code>BaseModel<\/code> \uc774\ub2e4.<\/p>\n\n<div class=\"code-block\"># main.py\nfrom fastapi import FastAPI\nfrom pydantic import BaseModel\n\napp = FastAPI()\n\nclass Item(BaseModel):\n    name: str\n    price: float\n    is_offer: bool = False\n\n@app.post(&#8220;\/items&#8221;)\ndef create_item(item: Item):\n    total = item.price * 1.1  # \ubd80\uac00\uc138 \ud3ec\ud568\n    return {&#8220;name&#8221;: item.name, &#8220;price_with_tax&#8221;: total}<\/div>\n\n<p>\uc5ec\uae30\uc11c \uc77c\uc5b4\ub098\ub294 \uc77c\uc744 \ud480\uc5b4 \ubcf4\uc790. <code>Item<\/code> \uc740 &#8220;\uc774 \ubcf8\ubb38\uc5d0\ub294 \ubb38\uc790\uc5f4 <code>name<\/code>, \uc2e4\uc218 <code>price<\/code>, \ubd88\ub9ac\uc5b8 <code>is_offer<\/code> \uac00 \ub4e4\uc5b4\uc628\ub2e4&#8221; \ub294 \uba85\uc138\ub2e4. <code>is_offer<\/code> \uc5d0 <code>= False<\/code> \ub97c \uc92c\uc73c\ub2c8 \uadf8 \ud544\ub4dc\ub294 <strong>\uc120\ud0dd<\/strong>\uc774\uace0, \uc5c6\uc73c\uba74 <code>False<\/code> \uac00 \ucc44\uc6cc\uc9c4\ub2e4. \ud568\uc218 \uc778\uc790\uc5d0 <code>item: Item<\/code> \uc774\ub77c\uace0 \uc801\uc740 \uc21c\uac04 FastAPI \ub294 \uc778\uc790 \uc774\ub984\uc774 \uacbd\ub85c\uc5d0\ub3c4 \ucffc\ub9ac\uc5d0\ub3c4 \uc5c6\ub294 <strong>\ubaa8\ub378 \ud0c0\uc785<\/strong>\uc784\uc744 \ubcf4\uace0 &#8220;\uc544, \uc774\uac74 \ubcf8\ubb38\uc5d0\uc11c \uaebc\ub0b4\ub77c\ub294 \ub73b&#8221; \uc774\ub77c\uace0 \ud310\ub2e8\ud55c\ub2e4.<\/p>\n\n<p>\uadf8\ub798\uc11c \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc774\ub7f0 JSON \uc744 \ubcf4\ub0b4\uba74,<\/p>\n\n<div class=\"code-block\">POST \/items\n{\n  &#8220;name&#8221;: &#8220;\ud0a4\ubcf4\ub4dc&#8221;,\n  &#8220;price&#8221;: 39000,\n  &#8220;is_offer&#8221;: true\n}<\/div>\n\n<p>FastAPI \uac00 \ubcf8\ubb38\uc744 \uc77d\uc5b4 <code>Item<\/code> \uac1d\uccb4\ub85c <strong>\ud30c\uc2f1\ud558\uace0 \uac80\uc99d\ud55c \ub4a4<\/strong> \ud568\uc218\uc5d0 \ub118\uae34\ub2e4. \ud568\uc218 \uc548\uc5d0\uc11c\ub294 <code>item.name<\/code>, <code>item.price<\/code> \ucc98\ub7fc \uc810\uc73c\ub85c \uaebc\ub0b4 \uc4f4\ub2e4. \ub354 \uc774\uc0c1 <code>request.json()<\/code> \uc744 \uc9c1\uc811 \ubd80\ub974\uac70\ub098 \ud0a4\uac00 \uc788\ub294\uc9c0 \uc77c\uc77c\uc774 \ud655\uc778\ud560 \ud544\uc694\uac00 \uc5c6\ub2e4. \uadf8\ub9ac\uace0 2\ud3b8\uc758 \uacbd\ub85c\u00b7\ucffc\ub9ac\ucc98\ub7fc, \uc774 \ubaa8\ub378 \uad6c\uc870 \uc5ed\uc2dc <code>\/docs<\/code> \ubb38\uc11c\uc5d0 \uc785\ub825 \uc608\uc2dc\ub85c \uadf8\ub300\ub85c \uadf8\ub824\uc9c4\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>\ub515\uc154\ub108\ub9ac\ub85c \ub2e4\uc2dc \ubc14\uafb8\ub824\uba74<\/strong> \u2014 \ubc1b\uc740 \ubaa8\ub378\uc744 \uadf8\ub300\ub85c \ub2e4\ub978 \ud568\uc218\uc5d0 \ub118\uae30\uac70\ub098 \uc800\uc7a5\ud560 \ub54c <code>item.model_dump()<\/code> \ub97c \uc4f0\uba74 \ud3c9\ubc94\ud55c \ub515\uc154\ub108\ub9ac\uac00 \ub41c\ub2e4. Pydantic v1 \uc758 <code>.dict()<\/code> \uac00 v2 \uc5d0\uc11c <code>.model_dump()<\/code> \ub85c \ubc14\ub00c\uc5c8\uc73c\ub2c8, \uc61b \uc608\uc81c\ub97c \ubcfc \ub54c \ud5f7\uac08\ub9ac\uc9c0 \ub9d0 \uac83. \uc9c1\ub82c\ud654\ub41c JSON \ubb38\uc790\uc5f4\uc774 \ud544\uc694\ud558\uba74 <code>item.model_dump_json()<\/code> \uc774\ub2e4.\n<\/div>\n\n<h2>3. Field \ub85c \uac80\uc99d \uac15\ud654 \u2014 \ud0c0\uc785\ub9cc\uc73c\ub85c \ubd80\uc871\ud560 \ub54c<\/h2>\n\n<p>\ud0c0\uc785\ud78c\ud2b8\ub294 &#8220;\ubb38\uc790\uc5f4\uc774\ub0d0 \uc22b\uc790\ub0d0&#8221; \uae4c\uc9c0\ub294 \uc7a1\uc9c0\ub9cc, &#8220;\uc774\ub984\uc740 \ube44\uba74 \uc548 \ub418\uace0 50\uc790 \uc774\ud558&#8221;, &#8220;\ub098\uc774\ub294 0~120 \uc0ac\uc774&#8221; \uac19\uc740 <strong>\uac12\uc758 \ubc94\uc704<\/strong>\ub294 \ubaa8\ub978\ub2e4. \uc774\ub7f0 \uc138\ubd80 \uaddc\uce59\uc740 Pydantic \uc758 <code>Field<\/code> \ub85c \ud544\ub4dc\ub9c8\ub2e4 \ud55c \uc904\uc529 \uc5b9\ub294\ub2e4. \uc774\uba54\uc77c \ud615\uc2dd \uac80\uc99d\ucc98\ub7fc \uc790\uc8fc \uc4f0\ub294 \ud328\ud134\uc740 <code>EmailStr<\/code> \uac19\uc740 \uc804\uc6a9 \ud0c0\uc785\uc774 \ub530\ub85c \uc900\ube44\ub3fc \uc788\ub2e4.<\/p>\n\n<div class=\"code-block\">from pydantic import BaseModel, Field, EmailStr\n\nclass UserCreate(BaseModel):\n    name: str = Field(min_length=1, max_length=50)\n    email: EmailStr\n    age: int = Field(ge=0, le=120)\n    bio: str = Field(default=&#8221;&#8221;, max_length=300)\n\n@app.post(&#8220;\/users&#8221;)\ndef create_user(user: UserCreate):\n    return {&#8220;name&#8221;: user.name, &#8220;email&#8221;: user.email}<\/div>\n\n<p>\uc81c\uc57d\uc744 \ud558\ub098\uc529 \ubcf4\uba74 \u2014 <code>min_length=1<\/code> \uc740 \ube48 \uc774\ub984\uc744 \ub9c9\uace0, <code>max_length=50<\/code> \uc740 \ub108\ubb34 \uae34 \uc785\ub825\uc744 \uc790\ub978\ub2e4. <code>ge=0<\/code> \ub294 &#8220;0 \uc774\uc0c1&#8221;, <code>le=120<\/code> \uc740 &#8220;120 \uc774\ud558&#8221; \ub77c\ub294 \ub73b\uc774\ub77c \uc74c\uc218 \ub098\uc774\ub098 \ube44\ud604\uc2e4\uc801\uc778 \uac12\uc744 \uac70\ub978\ub2e4. <code>EmailStr<\/code> \uc740 <code>@<\/code> \uac00 \uc5c6\uac70\ub098 \ud615\uc2dd\uc774 \uae68\uc9c4 \ubb38\uc790\uc5f4\uc744 \uc54c\uc544\uc11c \ud1f4\uc9dc \ub193\ub294\ub2e4. (\ucc38\uace0\ub85c <code>EmailStr<\/code> \uc744 \uc4f0\ub824\uba74 <code>pip install \"pydantic[email]\"<\/code> \ub85c \ubd80\uac00 \ud328\ud0a4\uc9c0\ub97c \ud55c \ubc88 \uae54\uc544 \ub46c\uc57c \ud55c\ub2e4.)<\/p>\n\n<p>\uc774 \uaddc\uce59\ub4e4\uc744 \uc5b4\uae34 \uc694\uccad\uc774 \uc624\uba74, \ud568\uc218 \ubcf8\ubb38\uc740 <strong>\uc2e4\ud589\uc870\ucc28 \ub418\uc9c0 \uc54a\uace0<\/strong> FastAPI \uac00 \uace7\uc7a5 <code>422 Unprocessable Entity<\/code> \uc751\ub2f5\uc744 \ub3cc\ub824\uc900\ub2e4. \ubcf8\ubb38\uc5d0 \uc5b4\ub290 \ud544\ub4dc\uac00 \uc65c \ud2c0\ub838\ub294\uc9c0\uac00 \uce5c\uc808\ud788 \ub2f4\uae34\ub2e4.<\/p>\n\n<div class=\"code-block\">{\n  &#8220;detail&#8221;: [{\n    &#8220;loc&#8221;: [&#8220;body&#8221;, &#8220;age&#8221;],\n    &#8220;msg&#8221;: &#8220;Input should be less than or equal to 120&#8221;,\n    &#8220;type&#8221;: &#8220;less_than_equal&#8221;\n  }]\n}<\/div>\n\n<p>\uc8fc\ubaa9\ud560 \uc810\uc740 <code>\"loc\": [\"body\", \"age\"]<\/code> \ub2e4. 2\ud3b8\uc5d0\uc11c \uacbd\ub85c \uac80\uc99d \uc5d0\ub7ec\uac00 <code>[\"path\", \"user_id\"]<\/code> \uc600\ub358 \uac83\uacfc \uac19\uc740 \uad6c\uc870\ub85c, \uc774\ubc88\uc5d4 <strong>\ubcf8\ubb38\uc758 age \ud544\ub4dc<\/strong>\uac00 \ubb38\uc81c\ub77c\uace0 \uc815\ud655\ud788 \uc9da\uc5b4 \uc900\ub2e4. \uc6b0\ub9ac\ub294 \uac80\uc99d \ucf54\ub4dc\ub3c4, \uc5d0\ub7ec \uba54\uc2dc\uc9c0\ub3c4 \ud55c \uc904 \uc548 \uc801\uc5c8\ub2e4.<\/p>\n\n<h2>4. response_model \u2014 \uc751\ub2f5 \ubaa8\uc591\uc744 \uace0\uc815\ud558\uace0 \ubbfc\uac10 \ud544\ub4dc\ub97c \uac70\ub978\ub2e4<\/h2>\n\n<p>\uc9c0\uae08\uae4c\uc9c0\ub294 <strong>\ub4e4\uc5b4\uc624\ub294<\/strong> \ub370\uc774\ud130\ub97c \ub2e4\ub918\ub2e4. \uadf8\ub7f0\ub370 <strong>\ub098\uac00\ub294<\/strong> \ub370\uc774\ud130\ub3c4 \ub611\uac19\uc774 \uc911\uc694\ud558\ub2e4. \ubc29\uae08 \ub9cc\ub4e0 <code>UserCreate<\/code> \uc5d0\ub294 \ube44\ubc00\ubc88\ud638\uac00 \ub4e4\uc5b4\uc62c \ud150\ub370, \ud68c\uc6d0\uac00\uc785 \uc751\ub2f5\uc73c\ub85c \uadf8 \ube44\ubc00\ubc88\ud638\ub97c \uadf8\ub300\ub85c \ub3cc\ub824\uc8fc\uba74 \ud070\uc77c\uc774\ub2e4. FastAPI \ub294 <strong>\uc785\ub825 \ubaa8\ub378\uacfc \ucd9c\ub825 \ubaa8\ub378\uc744 \ubd84\ub9ac<\/strong>\ud574\uc11c \uc774 \ubb38\uc81c\ub97c \uae54\ub054\ud788 \ud47c\ub2e4.<\/p>\n\n<div class=\"code-block\">class UserCreate(BaseModel):\n    name: str = Field(min_length=1, max_length=50)\n    email: EmailStr\n    password: str = Field(min_length=8)\n\nclass UserPublic(BaseModel):\n    name: str\n    email: EmailStr\n    # password \uc5c6\uc74c \u2014 \uc751\ub2f5\uc5d0\uc11c \uc790\ub3d9\uc73c\ub85c \ube60\uc9c4\ub2e4\n\n@app.post(&#8220;\/users&#8221;, response_model=UserPublic)\ndef create_user(user: UserCreate):\n    save_to_db(user)          # \uc800\uc7a5\uc740 password \ud3ec\ud568\ud574\uc11c\n    return user               # \ubc18\ud658\ud574\ub3c4 password \ub294 \uc751\ub2f5\uc5d0\uc11c \uc81c\uac70\ub428<\/div>\n\n<p>\ud575\uc2ec\uc740 \ub370\ucf54\ub808\uc774\ud130\uc758 <code>response_model=UserPublic<\/code> \uc774\ub2e4. \ud568\uc218\uac00 \ube44\ubc00\ubc88\ud638\uae4c\uc9c0 \ub4e0 <code>user<\/code> \ub97c \ud1b5\uc9f8\ub85c <code>return<\/code> \ud574\ub3c4, FastAPI \ub294 \uc751\ub2f5\uc744 <strong><code>UserPublic<\/code> \uc758 \ubaa8\uc591\uc5d0 \ub9de\ucdb0 \ub2e4\uc2dc \ube5a\ub294\ub2e4<\/strong>. <code>UserPublic<\/code> \uc5d0 <code>password<\/code> \uac00 \uc5c6\uc73c\ub2c8 \uadf8 \ud544\ub4dc\ub294 \uc751\ub2f5 JSON \uc5d0\uc11c <strong>\uc790\ub3d9\uc73c\ub85c \uc0ac\ub77c\uc9c4\ub2e4<\/strong>. \uac1c\ubc1c\uc790\uac00 &#8220;\uc774 \ud544\ub4dc\ub294 \ube7c\uc57c\uc9c0&#8221; \ud558\uace0 \uc190\uc73c\ub85c \uc9c0\uc6b8 \ud544\uc694\uac00 \uc5c6\uc5b4, \uc2e4\uc218\ub85c \ubbfc\uac10 \uc815\ubcf4\ub97c \ud758\ub9b4 \uc704\ud5d8\uc774 \uad6c\uc870\uc801\uc73c\ub85c \uc904\uc5b4\ub4e0\ub2e4.<\/p>\n\n<p><code>response_model<\/code> \uc740 \ubcf4\uc548\ub9cc \uc704\ud55c \uac8c \uc544\ub2c8\ub2e4. \uc751\ub2f5\uc758 <strong>\ubaa8\uc591\uc744 \uacc4\uc57d\ucc98\ub7fc \uace0\uc815<\/strong>\ud558\ub294 \uc5ed\ud560\ub3c4 \ud55c\ub2e4. \ud568\uc218\uac00 \ub0b4\ubd80 \uc0ac\uc815\uc73c\ub85c \ud544\ub4dc\ub97c \ub354 \ubd99\uc5ec \ubc18\ud658\ud558\ub354\ub77c\ub3c4, \ucd9c\ub825 \ubaa8\ub378\uc5d0 \uc5c6\ub294 \ud544\ub4dc\ub294 \uc798\ub824 \ub098\uac00\ubbc0\ub85c \ud504\ub860\ud2b8\uc5d4\ub4dc\uac00 \ubc1b\ub294 JSON \ud615\ud0dc\uac00 \ud56d\uc0c1 \uc77c\uc815\ud558\ub2e4. \uadf8\ub9ac\uace0 \uc774 \ucd9c\ub825 \uc2a4\ud0a4\ub9c8 \ub610\ud55c <code>\/docs<\/code> \uc5d0 &#8220;\uc774 API \ub294 \uc774\ub7f0 \ubaa8\uc591\uc73c\ub85c \uc751\ub2f5\ud55c\ub2e4&#8221; \uace0 \uadf8\ub824\uc9c4\ub2e4.<\/p>\n\n<p>\ubaa8\ub378\uc740 \ud3c9\ud3c9\ud558\uae30\ub9cc \ud55c \uac8c \uc544\ub2c8\ub2e4. \ud544\ub4dc\uc758 \ud0c0\uc785\uc73c\ub85c <strong>\ub2e4\ub978 \ubaa8\ub378<\/strong>\uc774\ub098 <strong>\ubaa8\ub378\uc758 \ub9ac\uc2a4\ud2b8<\/strong>\ub97c \uadf8\ub300\ub85c \uc4f8 \uc218 \uc788\uc5b4 \uc911\ucca9 \uad6c\uc870\ub3c4 \uc790\uc5f0\uc2a4\ub7fd\ub2e4. \uc608\ub97c \ub4e4\uc5b4 \uc0ac\uc6a9\uc790\uac00 \uc5ec\ub7ec \uc8fc\ubb38\uc744 \uac00\uc9c4\ub2e4\uba74, <code>class Order(BaseModel)<\/code> \ub97c \ub530\ub85c \uc815\uc758\ud558\uace0 <code>orders: list[Order] = []<\/code> \ucc98\ub7fc \ud55c \uc904\ub85c \ub07c\uc6cc \ub123\uc73c\uba74 \ub41c\ub2e4. FastAPI \ub294 \uc774 \uc911\ucca9\uae4c\uc9c0 \uac80\uc99d\ud558\uace0 \ubb38\uc11c\ub85c \uadf8\ub824 \uc900\ub2e4.<\/p>\n\n<div class=\"warnbox\">\n<strong>\ud754\ud55c \ud568\uc815<\/strong> \u2014 \uc785\ub825\uacfc \ucd9c\ub825\uc744 \uac19\uc740 \ubaa8\ub378 \ud558\ub098\ub85c \ub3cc\ub824\uc4f0\uace0 \uc2f6\uc740 \uc720\ud639\uc774 \ud06c\ub2e4. \ud558\uc9c0\ub9cc \uadf8\ub7ec\uba74 \ube44\ubc00\ubc88\ud638 \uac19\uc740 \ud544\ub4dc\uac00 \uc751\ub2f5\uc5d0 \uc0c8\uac70\ub098, \ubc18\ub300\ub85c \uc751\ub2f5\uc5d0\ub9cc \uc788\uc5b4\uc57c \ud560 <code>id<\/code>\u00b7<code>created_at<\/code> \uc744 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uad73\uc774 \ubcf4\ub0b4\uc57c \ud558\ub294 \ubaa8\uc21c\uc774 \uc0dd\uae34\ub2e4. <strong>\uc785\ub825\uc6a9(Create)\uacfc \ucd9c\ub825\uc6a9(Public)\uc744 \ucc98\uc74c\ubd80\ud130 \ub098\ub220<\/strong> \uc815\uc758\ud558\ub294 \uc2b5\uad00\uc774 \uae38\uac8c \ubcf4\uba74 \ud6e8\uc52c \ud3b8\ud558\ub2e4.\n<\/div>\n\n<h3>\uc694\uc57d<\/h3>\n\n<p>3\ud3b8\uc744 \ud55c \uc904\ub85c \u2014 <strong>\ubb36\uc778 \ub370\uc774\ud130\ub294 \uc694\uccad \ubcf8\ubb38\uc5d0 \ub2f4\uace0, \uadf8 \ubaa8\uc591\uc744 Pydantic <code>BaseModel<\/code> \ub85c \uc120\uc5b8\ud558\uba74 \ud30c\uc2f1\u00b7\uac80\uc99d\uc774 \uacf5\uc9dc\ub85c \ub530\ub77c\uc628\ub2e4.<\/strong> <code>Field<\/code> \ub85c \uae38\uc774\u00b7\ubc94\uc704 \uac19\uc740 \uc138\ubd80 \uaddc\uce59\uc744 \uc5b9\uc73c\uba74 \uc5b4\uae0b\ub09c \uc694\uccad\uc740 \ud568\uc218 \uc55e\uc5d0\uc11c <code>422<\/code> \ub85c \uac78\ub9ac\uace0, <code>response_model<\/code> \ub85c \ucd9c\ub825 \ubaa8\ub378\uc744 \ub530\ub85c \ub450\uba74 \ube44\ubc00\ubc88\ud638 \uac19\uc740 \ubbfc\uac10 \ud544\ub4dc\ub97c \uc751\ub2f5\uc5d0\uc11c \uc790\ub3d9\uc73c\ub85c \uac78\ub7ec \ub0b4\uace0 \uc751\ub2f5 \ubaa8\uc591\uc744 \uacc4\uc57d\ucc98\ub7fc \uace0\uc815\ud55c\ub2e4. \uc785\ub825 <code>UserCreate<\/code> \uc640 \ucd9c\ub825 <code>UserPublic<\/code> \uc744 \ub098\ub204\ub294 \uac83\uc774 \ud575\uc2ec \uc2b5\uad00\uc774\ub2e4. \uadf8\ub7f0\ub370 \uac80\uc99d\uc774 \uc2e4\ud328\ud558\uba74 \uc815\ud655\ud788 \uc5b4\ub5a4 \uc5d0\ub7ec\uac00 \ub098\uac00\uace0, \uc131\uacf5\ud558\uba74 \uc5b4\ub5a4 \uc0c1\ud0dc\ucf54\ub4dc\uac00 \ubd99\ub294 \uac78\uae4c? 4\ud3b8\uc5d0\uc11c \uadf8 \uc5d0\ub7ec\uc640 \uc0c1\ud0dc\ucf54\ub4dc\ub97c \uc190\uc5d0 \uc950\uace0 \ub2e4\ub8ec\ub2e4.<\/p>\n\n<div class=\"cta\">\n<h3>\ub2e4\uc74c \ud3b8 \uc608\uace0 \u2014 \uc5d0\ub7ec \ucc98\ub9ac\uc640 \uc0c1\ud0dc\ucf54\ub4dc<\/h3>\n<p>\uac80\uc99d\uc774 \uc2e4\ud328\ud558\uba74 \uc5b4\ub5a4 \uc5d0\ub7ec\uac00, \uc131\uacf5\ud558\uba74 \uc5b4\ub5a4 \uc0c1\ud0dc\ucf54\ub4dc\uac00 \ub098\uac00\ub294\uc9c0. HTTPException \uc73c\ub85c \uc9c1\uc811 \uc5d0\ub7ec\ub97c \ub358\uc9c0\ub294 \ubc95\uae4c\uc9c0.<\/p>\n<\/div>\n\n<div class=\"footer-nav\">\n\uc2dc\ub9ac\uc988 \u00b7 <a href=\"https:\/\/junai.ai\/blog\/category\/fastapi\/\">\uc27d\uac8c \ubc30\uc6b0\ub294 FastAPI<\/a> \u00b7 \ud568\uaed8 \ubcf4\uae30: <a href=\"https:\/\/junai.ai\/blog\/category\/python\/\">\ud30c\uc774\uc36c \uae30\ucd08 \uc2dc\ub9ac\uc988<\/a>\n<\/div>\n\n<\/article>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>\ubb36\uc778 \ub370\uc774\ud130\ub97c \uc694\uccad \ubcf8\ubb38\uc73c\ub85c \ubc1b\ub294 \ubc95. Pydantic \ubaa8\ub378\ub85c \uc790\ub3d9 \uac80\uc99d\ud558\uace0 response_model \ub85c \uc751\ub2f5 \ubaa8\uc591\uc744 \uace0\uc815\ud55c\ub2e4. \uad50\uc7ac 3\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":925,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-938","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-fastapi"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/938","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/comments?post=938"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/938\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/925"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=938"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=938"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=938"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}