fastapi/docs/em/docs/tutorial/schema-extra-example.md

📣 📨 🖼 💽

👆 💪 📣 🖼 💽 👆 📱 💪 📨.

📥 📚 🌌 ⚫️.

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️⃣,, 🔜, ⚫️ 👍 😣 ⚙️ 💭 🔛.