contact Các trường| Tham số | Kiểu | Mô tả |
|---|---|---|
name | str | Tên nhận dạng của người liên hệ/tổ chức. |
url | str | URL chỉ đến thông tin liên hệ. PHẢI là định dạng URL. |
email | str | Địa chỉ email của người liên hệ/tổ chức. PHẢI là định dạng email. |
license_info Các trường| Tham số | Kiểu | Mô tả |
|---|---|---|
name | str | BẮT BUỘC (Nếu có một license_info được thiết lập). Tên chứng chỉ của API được sử dụng. |
identifier | str | Một biểu thức giấy phép SPDX cho API. Trường identifier và trường url loại trừ lẫn nhau (không thể dùng đồng thời). Có sẵn từ OpenAPI 3.1.0, FastAPI 0.99.0. |
url | str | URL đến giấy phép được sử dụng cho API. PHẢI ở định dạng URL. |
+
+## License identifier
+
+Kể từ OpenAPI 3.1.0 và FastAPI 0.99.0, bạn cũng có thể thiết lập `license_info` với `identifier` thay vì `url`.
+
+Ví dụ:
+
+{* ../../docs_src/metadata/tutorial001_1.py hl[31] *}
+
+## Metadata cho tags
+
+Bạn cũng có thể thêm metadata bổ sung cho các tags khác nhau được sử dụng để nhóm các path operations của bạn với tham số `openapi_tags`.
+
+Nó lấy một danh sách chứa một dictionary cho mỗi tag.
+
+Mỗi dictionary có thể chứa:
+
+* `name` (**bắt buộc**): một `str` với tên tag giống như khi bạn sử dụng trong tham số `tags` của các *path operations* và `APIRouter`s.
+* `description`: một `str` với mô tả ngắn cho tag. Nó có thể sử dụng Markdown và sẽ được hiển thị trong giao diện tài liệu.
+* `externalDocs`: một `dict` mô tả tài liệu bên ngoài với:
+ * `description`: một `str` với mô tả ngắn cho tài liệu bên ngoài.
+ * `url` (**bắt buộc**): một `str` với URL cho tài liệu bên ngoài.
+
+### Tạo metadata cho tags
+
+Hãy thử điều đó trong ví dụ với tags `users` và `items`.
+
+Tạo metadata cho tags và chuyển nó đến tham số `openapi_tags`:
+
+{* ../../docs_src/metadata/tutorial004.py hl[3:16,18] *}
+
+Lưu ý rằng bạn có thể sử dụng Markdown trong các mô tả, ví dụ "login" sẽ được hiển thị in đậm (**login**) và "fancy" sẽ được hiển thị in nghiêng (_fancy_).
+
+/// tip
+
+Bạn không cần thêm metadata cho tất cả các tags mà bạn sử dụng.
+
+///
+
+### Sử dụng tags của bạn
+
+Sử dụng tham số `tags` với các *path operations* (và `APIRouter`s) để gán chúng cho các tags khác nhau:
+
+{* ../../docs_src/metadata/tutorial004.py hl[21,26] *}
+
+/// info
+
+Đọc thêm về tag trong phần [Cấu hình Path Operations](path-operation-configuration.md#tags){.internal-link target=_blank}.
+
+///
+
+### Kiểm tra tài liệu
+
+Bây giờ, nếu bạn kiểm tra tài liệu, chúng sẽ hiển thị tất cả các metadata bổ sung:
+
+
+
+### Thứ tự của tags
+
+Thứ tự của mỗi dictionary metadata tag cũng xác định thứ tự hiển thị trong giao diện tài liệu.
+
+Ví dụ, mặc dù `users` sẽ đứng sau `items` theo thứ tự bảng chữ cái, nhưng nó được hiển thị trước chúng, vì chúng ta đã thêm metadata của chúng nó làm dictionary đầu tiên trong danh sách.
+
+## URL OpenAPI
+
+Mặc định, schema OpenAPI được phục vụ tại `/openapi.json`.
+
+Nhưng bạn có thể cấu hình nó với tham số `openapi_url`.
+
+Ví dụ, để đặt nó được phục vụ tại `/api/v1/openapi.json`:
+
+{* ../../docs_src/metadata/tutorial002.py hl[3] *}
+
+Nếu bạn muốn vô hiệu hóa hoàn toàn schema OpenAPI hoàn toàn, bạn có thể đặt `openapi_url=None`, điều đó cũng sẽ tắt các giao diện tài liệu sử dụng nó.
+
+## URL tài liệu
+
+Bạn có thể cấu hình hai giao diện tài liệu được tích hợp:
+
+* **Swagger UI**: được phục vụ tại `/docs`.
+ * Bạn có thể đặt URL của nó với tham số `docs_url`.
+ * Bạn có thể vô hiệu hóa nó bằng cách đặt `docs_url=None`.
+* **ReDoc**: được phục vụ tại `/redoc`.
+ * Bạn có thể đặt URL của nó với tham số `redoc_url`.
+ * Bạn có thể vô hiệu hóa nó bằng cách đặt `redoc_url=None`.
+
+Ví dụ, để đặt Swagger UI được phục vụ tại `/documentation` và vô hiệu hóa ReDoc:
+
+{* ../../docs_src/metadata/tutorial003.py hl[3] *}