tiangolo.fastapi/docs/em/docs/tutorial/metadata.md

🗃 & 🩺 📛

👆 💪 🛃 📚 🗃 📳 👆 FastAPI 🈸.

🗃 🛠️

👆 💪 ⚒ 📄 🏑 👈 ⚙️ 🗄 🔧 & 🏧 🛠️ 🩺 ⚜:

🔢	🆎	📛
title	str	📛 🛠️.
description	str	📏 📛 🛠️. ⚫️ 💪 ⚙️ ✍.
version	string	⏬ 🛠️. 👉 ⏬ 👆 👍 🈸, 🚫 🗄. 🖼 2.5.0.
terms_of_service	str	📛 ⚖ 🐕‍🦺 🛠️. 🚥 🚚, 👉 ✔️ 📛.
contact	dict	📧 ℹ 🎦 🛠️. ⚫️ 💪 🔌 📚 🏑. contact 🏑 🔢 🆎 📛 name str ⚖ 📛 📧 👨‍💼/🏢. url str 📛 ☝ 📧 ℹ. 🔜 📁 📛. email str 📧 📢 📧 👨‍💼/🏢. 🔜 📁 📧 📢.
license_info	dict	🛂 ℹ 🎦 🛠️. ⚫️ 💪 🔌 📚 🏑. license_info 🏑 🔢 🆎 📛 name str 🚚 (🚥 license_info ⚒). 🛂 📛 ⚙️ 🛠️. url str 📛 🛂 ⚙️ 🛠️. 🔜 📁 📛.

👆 💪 ⚒ 👫 ⏩:

{!../../../docs_src/metadata/tutorial001.py!}

!!! tip 👆 💪 ✍ ✍ description 🏑 & ⚫️ 🔜 ✍ 🔢.

⏮️ 👉 📳, 🏧 🛠️ 🩺 🔜 👀 💖:

🗃 🔖

👆 💪 🚮 🌖 🗃 🎏 🔖 ⚙️ 👪 👆 ➡ 🛠️ ⏮️ 🔢 openapi_tags.

⚫️ ✊ 📇 ⚗ 1️⃣ 📖 🔠 🔖.

🔠 📖 💪 🔌:

• name (✔): str ⏮️ 🎏 📛 👆 ⚙️ tags 🔢 👆 ➡ 🛠️ & APIRouterⓂ.
• description: str ⏮️ 📏 📛 🔖. ⚫️ 💪 ✔️ ✍ & 🔜 🎦 🩺 🎚.
• externalDocs: dict 🔬 🔢 🧾 ⏮️:
  • description: str ⏮️ 📏 📛 🔢 🩺.
  • url (✔): str ⏮️ 📛 🔢 🧾.

✍ 🗃 🔖

➡️ 🔄 👈 🖼 ⏮️ 🔖 users & items.

✍ 🗃 👆 🔖 & 🚶‍♀️ ⚫️ openapi_tags 🔢:

{!../../../docs_src/metadata/tutorial004.py!}

👀 👈 👆 💪 ⚙️ ✍ 🔘 📛, 🖼 "💳" 🔜 🎦 🦁 (💳) & "🎀" 🔜 🎦 ❕ (🎀).

!!! tip 👆 🚫 ✔️ 🚮 🗃 🌐 🔖 👈 👆 ⚙️.

⚙️ 👆 🔖

⚙️ tags 🔢 ⏮️ 👆 ➡ 🛠️ (& APIRouterⓂ) 🛠️ 👫 🎏 🔖:

{!../../../docs_src/metadata/tutorial004.py!}

!!! info ✍ 🌅 🔃 🔖 ➡ 🛠️ 📳{.internal-link target=_blank}.

✅ 🩺

🔜, 🚥 👆 ✅ 🩺, 👫 🔜 🎦 🌐 🌖 🗃:

✔ 🔖

✔ 🔠 🔖 🗃 📖 🔬 ✔ 🎦 🩺 🎚.

🖼, ✋️ users 🔜 🚶 ⏮️ items 🔤 ✔, ⚫️ 🎦 ⏭ 👫, ↩️ 👥 🚮 👫 🗃 🥇 📖 📇.

🗄 📛

🔢, 🗄 🔗 🍦 /openapi.json.

✋️ 👆 💪 🔗 ⚫️ ⏮️ 🔢 openapi_url.

🖼, ⚒ ⚫️ 🍦 /api/v1/openapi.json:

{!../../../docs_src/metadata/tutorial002.py!}

🚥 👆 💚 ❎ 🗄 🔗 🍕 👆 💪 ⚒ openapi_url=None, 👈 🔜 ❎ 🧾 👩‍💻 🔢 👈 ⚙️ ⚫️.

🩺 📛

👆 💪 🔗 2️⃣ 🧾 👩‍💻 🔢 🔌:

• 🦁 🎚: 🍦 /docs.
  • 👆 💪 ⚒ 🚮 📛 ⏮️ 🔢 docs_url.
  • 👆 💪 ❎ ⚫️ ⚒ docs_url=None.
• 📄: 🍦 /redoc.
  • 👆 💪 ⚒ 🚮 📛 ⏮️ 🔢 redoc_url.
  • 👆 💪 ❎ ⚫️ ⚒ redoc_url=None.

🖼, ⚒ 🦁 🎚 🍦 /documentation & ❎ 📄:

{!../../../docs_src/metadata/tutorial003.py!}