labels.data_config_details=Data Config Details
labels.dict_kuromoji_details=Kuromoji Dictionary Details
labels.dict_mapping_details=Mapping Dictionary Details
labels.dict_protwords_details=Protected Words Dictionary Details
labels.dict_stemmeroverride_details=Stemmer Override Dictionary Details
labels.dict_stopwords_details=Stop Words Dictionary Details
labels.dict_synonym_details=Synonym Dictionary Details
labels.duplicate_host_details=Duplicate Host Details

## Metadata for tags { #metadata-for-tags }

You can also add additional metadata for the different tags used to group your path operations with the parameter `openapi_tags`.

It takes a list containing one dictionary for each tag.

Each dictionary can contain:

* `name` (**required**): a `str` with the same tag name you use in the `tags` parameter in your *path operations* and `APIRouter`s.

labels.data_config_details=Data Config Details
labels.dict_kuromoji_details=Kuromoji Dictionary Details
labels.dict_mapping_details=Mapping Dictionary Details
labels.dict_protwords_details=Protected Words Dictionary Details
labels.dict_stemmeroverride_details=Stemmer Override Dictionary Details
labels.dict_stopwords_details=Stop Words Dictionary Details
labels.dict_synonym_details=Synonym Dictionary Details
labels.duplicate_host_details=Duplicate Host Details

例如：

{* ../../docs_src/metadata/tutorial001_1_py310.py hl[31] *}

## 標籤的中繼資料 { #metadata-for-tags }

你也可以透過 `openapi_tags` 參數，為用來分組你的路徑操作（path operation）的各個標籤加入額外中繼資料。

它接收一個 list，其中每個標籤對應一個 dictionary。

每個 dictionary 可包含：

* `name`（**必填**）：一個 `str`，其值需與你在路徑操作與 `APIRouter`s 的 `tags` 參數中使用的標籤名稱相同。
* `description`：一個 `str`，為該標籤的簡短描述。可使用 Markdown，並會顯示在文件介面中。
* `externalDocs`：一個 `dict`，描述外部文件，包含：

    /** The key of the message: Kuromoji Dictionary Details */
    public static final String LABELS_dict_kuromoji_details = "{labels.dict_kuromoji_details}";

    /** The key of the message: Mapping Dictionary Details */
    public static final String LABELS_dict_mapping_details = "{labels.dict_mapping_details}";

    /** The key of the message: Protected Words Dictionary Details */

To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.

`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.

FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.

5. You can use other standard type annotations with dataclasses as the request body.

    In this case, it's a list of `Item` dataclasses.

6. Here we are returning a dictionary that contains `items` which is a list of dataclasses.

    FastAPI is still capable of <dfn title="converting the data to a format that can be transmitted">serializing</dfn> the data to JSON.

* Declare a `Request` parameter in the *path operation* that will return a template.
* Use the `templates` you created to render and return a `TemplateResponse`, pass the name of the template, the request object, and a "context" dictionary with key-value pairs to be used inside of the Jinja2 template.

{* ../../docs_src/templates/tutorial001_py310.py hl[4,11,15:18] *}

/// note

Before FastAPI 0.108.0, Starlette 0.29.0, the `name` was the first parameter.

online.help.name.reqheader=reqheader
# Online help key for synonym dictionary.
online.help.name.dict.synonym=synonym
# Online help key for dictionary.
online.help.name.dict=dict
# Online help key for Kuromoji dictionary.
online.help.name.dict.kuromoji=kuromoji
# Online help key for protected words dictionary.
online.help.name.dict.protwords=protwords
# Online help key for stopwords dictionary.
online.help.name.dict.stopwords=stopwords

                },
                "x-aperture-labs-portal": "blue"
            }
        }
    }
}
```

### Custom OpenAPI *path operation* schema { #custom-openapi-path-operation-schema }

The dictionary in `openapi_extra` will be deeply merged with the automatically generated OpenAPI schema for the *path operation*.

So, you could add additional data to the automatically generated schema.