4.6 KiB
📣 📨 🖼 💽
👆 💪 📣 🖼 💽 👆 📱 💪 📨.
📥 📚 🌌 ⚫️.
Pydantic schema_extra
👆 💪 📣 example Pydantic 🏷 ⚙️ Config & schema_extra, 🔬 Pydantic 🩺: 🔗 🛃:
{* ../../docs_src/schema_extra_example/tutorial001.py hl[15:23] *}
👈 ➕ ℹ 🔜 🚮-🔢 🎻 🔗 👈 🏷, & ⚫️ 🔜 ⚙️ 🛠️ 🩺.
/// tip
👆 💪 ⚙️ 🎏 ⚒ ↔ 🎻 🔗 & 🚮 👆 👍 🛃 ➕ ℹ.
🖼 👆 💪 ⚙️ ⚫️ 🚮 🗃 🕸 👩💻 🔢, ♒️.
///
Field 🌖 ❌
🕐❔ ⚙️ Field() ⏮️ Pydantic 🏷, 👆 💪 📣 ➕ ℹ 🎻 🔗 🚶♀️ 🙆 🎏 ❌ ❌ 🔢.
👆 💪 ⚙️ 👉 🚮 example 🔠 🏑:
{* ../../docs_src/schema_extra_example/tutorial002.py hl[4,10:13] *}
/// warning
🚧 🤯 👈 📚 ➕ ❌ 🚶♀️ 🏆 🚫 🚮 🙆 🔬, 🕴 ➕ ℹ, 🧾 🎯.
///
example & examples 🗄
🕐❔ ⚙️ 🙆:
Path()Query()Header()Cookie()Body()Form()File()
👆 💪 📣 💽 example ⚖️ 👪 examples ⏮️ 🌖 ℹ 👈 🔜 🚮 🗄.
Body ⏮️ example
📥 👥 🚶♀️ example 📊 ⌛ Body():
{* ../../docs_src/schema_extra_example/tutorial003.py hl[20:25] *}
🖼 🩺 🎚
⏮️ 🙆 👩🔬 🔛 ⚫️ 🔜 👀 💖 👉 /docs:
Body ⏮️ 💗 examples
👐 👁 example, 👆 💪 🚶♀️ examples ⚙️ dict ⏮️ 💗 🖼, 🔠 ⏮️ ➕ ℹ 👈 🔜 🚮 🗄 💁♂️.
🔑 dict 🔬 🔠 🖼, & 🔠 💲 ➕1️⃣ dict.
🔠 🎯 🖼 dict examples 💪 🔌:
summary: 📏 📛 🖼.description: 📏 📛 👈 💪 🔌 ✍ ✍.value: 👉 ☑ 🖼 🎦, ✅dict.externalValue: 🎛value, 📛 ☝ 🖼. 👐 👉 5️⃣📆 🚫 🐕🦺 📚 🧰value.
{* ../../docs_src/schema_extra_example/tutorial004.py hl[21:47] *}
🖼 🩺 🎚
⏮️ examples 🚮 Body() /docs 🔜 👀 💖:
📡 ℹ
/// warning
👉 📶 📡 ℹ 🔃 🐩 🎻 🔗 & 🗄.
🚥 💭 🔛 ⏪ 👷 👆, 👈 💪 🥃, & 👆 🎲 🚫 💪 👉 ℹ, 💭 🆓 🚶 👫.
///
🕐❔ 👆 🚮 🖼 🔘 Pydantic 🏷, ⚙️ schema_extra ⚖️ Field(example="something") 👈 🖼 🚮 🎻 🔗 👈 Pydantic 🏷.
& 👈 🎻 🔗 Pydantic 🏷 🔌 🗄 👆 🛠️, & ⤴️ ⚫️ ⚙️ 🩺 🎚.
🎻 🔗 🚫 🤙 ✔️ 🏑 example 🐩. ⏮️ ⏬ 🎻 🔗 🔬 🏑 examples, ✋️ 🗄 3️⃣.0️⃣.3️⃣ ⚓️ 🔛 🗝 ⏬ 🎻 🔗 👈 🚫 ✔️ examples.
, 🗄 3️⃣.0️⃣.3️⃣ 🔬 🚮 👍 example 🔀 ⏬ 🎻 🔗 ⚫️ ⚙️, 🎏 🎯 (✋️ ⚫️ 👁 example, 🚫 examples), & 👈 ⚫️❔ ⚙️ 🛠️ 🩺 🎚 (⚙️ 🦁 🎚).
, 👐 example 🚫 🍕 🎻 🔗, ⚫️ 🍕 🗄 🛃 ⏬ 🎻 🔗, & 👈 ⚫️❔ 🔜 ⚙️ 🩺 🎚.
✋️ 🕐❔ 👆 ⚙️ example ⚖️ examples ⏮️ 🙆 🎏 🚙 (Query(), Body(), ♒️.) 📚 🖼 🚫 🚮 🎻 🔗 👈 🔬 👈 💽 (🚫 🗄 👍 ⏬ 🎻 🔗), 👫 🚮 🔗 ➡ 🛠️ 📄 🗄 (🏞 🍕 🗄 👈 ⚙️ 🎻 🔗).
Path(), Query(), Header(), & Cookie(), example ⚖️ examples 🚮 🗄 🔑, Parameter Object (🔧).
& Body(), File(), & Form(), example ⚖️ examples 📊 🚮 🗄 🔑, Request Body Object, 🏑 content, 🔛 Media Type Object (🔧).
🔛 🎏 ✋, 📤 🆕 ⏬ 🗄: 3️⃣.1️⃣.0️⃣, ⏳ 🚀. ⚫️ ⚓️ 🔛 ⏪ 🎻 🔗 & 🏆 🛠️ ⚪️➡️ 🗄 🛃 ⏬ 🎻 🔗 ❎, 💱 ⚒ ⚪️➡️ ⏮️ ⏬ 🎻 🔗, 🌐 👫 🤪 🔺 📉. 👐, 🦁 🎚 ⏳ 🚫 🐕🦺 🗄 3️⃣.1️⃣.0️⃣,, 🔜, ⚫️ 👍 😣 ⚙️ 💭 🔛.